gloomberb 0.16.5 → 0.17.0

package/src/app/pane-runtime/ticker-open-runtime.ts

@@ -111,11 +111,11 @@ export function useAppTickerOpenRuntime({
     return true;
   }, [pluginRegistry, stateRef]);
 
-  const placePinnedTickerTarget = useCallback((target: TickerOpenTarget, options?: PinTickerOptions) => {
+  const placePinnedTickerTarget = useCallback((target: TickerOpenTarget, options?: PinTickerOptions, typed?: string) => {
     const paneType = normalizePaneId(options?.paneType ?? TICKER_RESEARCH_PANE_ID);
     const paneDef = pluginRegistry.panes.get(paneType);
     if (!paneDef) return;
-    if (refuseWhileOwnerOff(target.symbol, options, () => placePinnedTickerTarget(target, options))) return;
+    if (refuseWhileOwnerOff(target.symbol, options, () => placePinnedTickerTarget(target, options, typed))) return;
 
     publishTickerOpenTarget(target);
     const symbol = target.symbol;
@@ -128,6 +128,12 @@ export function useAppTickerOpenRuntime({
     let existing = options?.forceNewPane
       ? null
       : findFixedTickerPaneForSymbol(currentLayout, paneType, symbol, instrument);
+    // A pane bound to the key as typed (the web terminal's first pane for ?ticker=7203:TSE) is the one the
+    // resolved listing (7203:JPX) settles.
+    const typedKey = typed?.trim().toUpperCase();
+    if (!options?.forceNewPane && !existing && typedKey && typedKey !== symbol) {
+      existing = findFixedTickerPaneForSymbol(currentLayout, paneType, typedKey, instrument);
+    }
     // Without a broker route, the public listing and an unnamed route are the same security: a link that names
     // neither still finds the DES the command bar opened on the public listing, and leaves its binding as it is.
     let keepBinding = false;
@@ -213,7 +219,7 @@ export function useAppTickerOpenRuntime({
       ? { symbol: selectedTicker.metadata.ticker, ticker: selectedTicker, created: false, instrument: options?.instrument, listing: options?.listing }
       : await resolveOpenTickerTarget(rawSymbol, options?.instrument === null);
     if (!target) return;
-    placePinnedTickerTarget(target, options);
+    placePinnedTickerTarget(target, options, rawSymbol);
     const action = attentionActionForPane(options?.paneType ?? TICKER_RESEARCH_PANE_ID);
     if (action && pluginRegistry.panes.has(options?.paneType ?? TICKER_RESEARCH_PANE_ID)) {
       recordAttention(publicTickerKey(target.symbol, target.listing?.exchange ?? target.ticker.metadata.exchange), action);

package/src/app/runtime/desktop-deeplink.ts

@@ -13,10 +13,12 @@ import type { DesktopWindowBridge } from "../../types/desktop-window";
 import { requestAccountManagementTab } from "../../plugins/builtin/account-management/navigation";
 import { openTeamPane } from "../../plugins/builtin/cloud/team/pane-request";
 import { chatController } from "../../plugins/builtin/chat/controller";
-import { getShare } from "../../shares/api";
+import { getShare, type ShareRecord } from "../../shares/api";
+import { openShareLink, registerShareOpener } from "../../shares/open";
 import { openPaneShare } from "../../shares/pane";
 import { PluginOffError, notifyPluginOff } from "../../plugins/plugin-off";
 import { materializeMarketplaceLayout } from "../../shares/portable-layout";
+import { settleTypedListingKey } from "../../tickers/listing-venues";
 
 type CloudDeepLinkRoute = {
   kind: "cloud-alerts" | "cloud-emails" | "cloud-roundup" | "cloud-success" | "cloud-teams";
@@ -475,11 +477,15 @@ function handleOpenNews(
       notifyError(pluginRegistry, "Ticker news is unavailable.");
       return;
     }
-    void pluginRegistry.createPaneFromTemplateAsync("ticker-news-pane", { symbol: action.symbol }).then(() => {
-      notifySuccess(pluginRegistry, action.message);
-    }).catch((error) => {
-      notifyError(pluginRegistry, error instanceof Error ? error.message : "Failed to open ticker news.");
-    });
+    // A link's 7203:TSE is the venue its symbol trades on; ticker and alert links settle it where they open.
+    void settleTypedListingKey(action.symbol, { store: pluginRegistry.tickerRepository, dataProvider: pluginRegistry.marketData })
+      .then((symbol) => pluginRegistry.createPaneFromTemplateAsync("ticker-news-pane", { symbol: symbol.toUpperCase() }))
+      .then(() => {
+        notifySuccess(pluginRegistry, action.message);
+      })
+      .catch((error) => {
+        notifyError(pluginRegistry, error instanceof Error ? error.message : "Failed to open ticker news.");
+      });
     return;
   }
 
@@ -509,15 +515,44 @@ async function handleOpenLayout(
   notifySuccess(options.pluginRegistry, `Layout "${entry.name}" added.`);
 }
 
-async function handleOpenShare(
-  action: Extract<DesktopDeepLinkAction, { type: "open-share" }>,
+/**
+ * Opens a pane share in this app: the web app's `?share=` hand-off, a
+ * gloomberb://share link and a share link in chat all come through here.
+ * With `fallback`, a share this app cannot read or that holds a snapshot
+ * goes there (its web page) instead of to an error.
+ */
+async function openShareInApp(
+  id: string,
   pluginRegistry: PluginRegistry,
+  options: { retry: () => void; fallback?: () => void },
 ): Promise<void> {
-  const share = await getShare(action.id, fetch, { trackView: false });
-  if (!share) throw new Error("This share is unavailable or has expired.");
-  if (share.kind !== "pane") throw new Error("This link contains a snapshot, not a live pane.");
-  await openPaneShare(pluginRegistry, share.data);
-  notifySuccess(pluginRegistry, action.message);
+  let share: ShareRecord | null;
+  try {
+    share = await getShare(id, fetch, { trackView: false });
+  } catch (error) {
+    if (options.fallback) options.fallback();
+    else notifyError(pluginRegistry, error instanceof Error ? error.message : "Could not open shared pane.");
+    return;
+  }
+  if (!share) {
+    notifyError(pluginRegistry, "This share is unavailable or has expired.");
+    return;
+  }
+  if (share.kind !== "pane") {
+    if (options.fallback) options.fallback();
+    else notifyError(pluginRegistry, "This link contains a snapshot, not a live pane.");
+    return;
+  }
+  try {
+    await openPaneShare(pluginRegistry, share.data);
+    notifySuccess(pluginRegistry, "Opened shared pane.");
+  } catch (error) {
+    if (error instanceof PluginOffError) {
+      notifyPluginOff(pluginRegistry, error, options.retry);
+      return;
+    }
+    notifyError(pluginRegistry, error instanceof Error ? error.message : "Could not open shared pane.");
+  }
 }
 
 export function handleDesktopDeepLink(rawUrl: string, options: DesktopDeepLinkHandlerOptions): void {
@@ -564,13 +599,7 @@ export function handleDesktopDeepLink(rawUrl: string, options: DesktopDeepLinkHa
       handleOpenNews(action, options.pluginRegistry);
       return;
     case "open-share":
-      void handleOpenShare(action, options.pluginRegistry).catch((error) => {
-        if (error instanceof PluginOffError) {
-          notifyPluginOff(options.pluginRegistry, error, () => handleDesktopDeepLink(rawUrl, options));
-          return;
-        }
-        notifyError(options.pluginRegistry, error instanceof Error ? error.message : "Could not open shared pane.");
-      });
+      void openShareInApp(action.id, options.pluginRegistry, { retry: () => handleDesktopDeepLink(rawUrl, options) });
       return;
     case "open-layout":
       void handleOpenLayout(action, options).catch((error) => {
@@ -595,6 +624,15 @@ export function useDesktopDeepLinkRuntime({
   pluginRegistry: PluginRegistry;
   stateRef: { current: AppState };
 }) {
+  // Share links opened inside the app (chat's share chips) take the same path, in every renderer.
+  useEffect(() => {
+    if (!initialized) return;
+    return registerShareOpener((id, { fallback }) => openShareInApp(id, pluginRegistry, {
+      fallback,
+      retry: () => openShareLink(id, fallback),
+    }));
+  }, [initialized, pluginRegistry]);
+
   useEffect(() => {
     if (!initialized || desktopWindowKind === "detached" || !desktopDeepLinkBridge) return;
     return desktopDeepLinkBridge.subscribe((deeplink) => {

package/src/app/runtime/startup.ts

@@ -6,7 +6,7 @@ import type { MarketDataCoordinator } from "../../market-data/coordinator";
 import { instrumentFromTicker, type InstrumentRef } from "../../market-data/request-types";
 import { useSavedLayoutWarmup } from "./layout-warmup";
 import { chatController } from "../../plugins/builtin/chat/controller";
-import { PLUGIN_MARKETPLACE_PANE_ID } from "../../plugins/builtin/plugin-marketplace/ids";
+import { PLUGIN_MARKETPLACE_PANE_ID } from "../../plugins/marketplace/ids";
 import type { LoadedExternalPlugin } from "../../plugins/loader";
 import type { PluginRegistry } from "../../plugins/registry";
 import type {

package/src/app.tsx

@@ -38,6 +38,7 @@ import type { LayoutBounds } from "./layout/pane-manager";
 import type { AppSessionSnapshot } from "./core/state/session-persistence";
 import type { MarketDataCoordinator } from "./market-data/coordinator";
 import { createAppNotifier } from "./notifications/app-notifier";
+import { attachNotificationLog } from "./notifications/notification-log";
 import { useBrokerImportRuntime } from "./app/runtime/broker-import";
 import { useDesktopDeepLinkRuntime } from "./app/runtime/desktop-deeplink";
 import { useDesktopApplicationMenuRuntime } from "./app/runtime/desktop-menu";
@@ -374,6 +375,11 @@ function AppInner({
 
   // Wire up app-level notifications.
   pluginRegistry.bindHost({ notify: appNotifier.notify });
+  // Missed alerts live in this device's state store. A detached window keeps
+  // its own in memory rather than overwrite the main window's.
+  useEffect(() => (
+    isDetachedWindow ? undefined : attachNotificationLog(pluginRegistry.persistence.pluginState)
+  ), [isDetachedWindow, pluginRegistry]);
 
   // Persist layout changes (switching, saving, deleting, renaming layouts).
   // The saved layouts also mirror live pane state and focus, so they change on

package/src/architecture/core-builtin-allowlist.json

@@ -2,10 +2,10 @@
   "src/api-client/askg.ts": ["cloud"],
   "src/app.tsx": ["cloud"],
   "src/app/global-shortcuts.ts": ["help"],
-  "src/app/pane-runtime/plugin-bindings.ts": ["broker-manager","layout-manager","plugin-marketplace"],
+  "src/app/pane-runtime/plugin-bindings.ts": ["broker-manager","layout-manager"],
   "src/app/runtime/broker-import.ts": ["portfolio-list"],
   "src/app/runtime/desktop-deeplink.ts": ["account-management","chat","cloud"],
-  "src/app/runtime/startup.ts": ["chat","plugin-marketplace"],
+  "src/app/runtime/startup.ts": ["chat"],
   "src/cli/commands/market.ts": ["holders","insider","research","sec"],
   "src/cli/commands/options-chain.ts": ["options","options-calculator"],
   "src/cli/commands/options-leaps.ts": ["options","vol-surface"],
@@ -23,7 +23,6 @@
   "src/components/command-bar/commands/direct/index.ts": ["broker-manager","portfolio-list"],
   "src/components/command-bar/routes/root/command-items.ts": ["portfolio-list"],
   "src/components/command-bar/routes/root/help-items.ts": ["help"],
-  "src/components/command-bar/routes/root/plugin-install.ts": ["plugin-marketplace"],
   "src/components/command-bar/routes/root/shortcut-items.ts": ["portfolio-list"],
   "src/components/command-bar/workflow/builtin.ts": ["cloud","portfolio-list"],
   "src/components/command-bar/workflow/collection-actions.ts": ["cloud","portfolio-list"],
@@ -32,30 +31,22 @@
   "src/components/feedback-dialog.tsx": ["cloud"],
   "src/components/form-modal/routes.ts": ["portfolio-list"],
   "src/components/index.ts": ["portfolio-list"],
-  "src/components/layout/missing-pane.tsx": ["plugin-marketplace"],
   "src/components/layout/shell/index.tsx": ["cloud"],
   "src/components/layout/status-bar-groups.ts": ["cloud"],
   "src/components/layout/status-bar.tsx": ["cloud"],
   "src/components/onboarding/use-onboarding-upgrade.ts": ["chat"],
   "src/components/onboarding/wizard-model.ts": ["portfolio-list"],
   "src/components/onboarding/wizard-positions.ts": ["portfolio-list"],
-  "src/layout-marketplace/gallery.tsx": ["cloud","plugin-marketplace"],
+  "src/layout-marketplace/gallery.tsx": ["cloud"],
   "src/layout-marketplace/linked-sync.ts": ["cloud"],
   "src/layout/desks.ts": ["chart-composer"],
-  "src/plugins/auto-update-node.ts": ["plugin-marketplace"],
-  "src/plugins/auto-update.ts": ["plugin-marketplace"],
-  "src/plugins/catalog-browser.ts": ["alerts","analytics","attention","awards","backtest","bond-calculator","catalysts","cds","central-bank-rates","changelog","chart-composer","clinical-trials","cloud","comment-letters","company-attention","company-kpis","connections","correlation","cot","cpi","credit-boards","credit-conditions","credit-documents","crypto-board","debt-maturities","dividend-yield","docs","doe","earnings-calls","earnings-ripple","econ","econ-statistics","equity-screener","estimate-revisions","executives","exposure","fear-greed","filing-events","futures","futures-curve","fx-matrix","gpu","help","insider","ipo-calendar","iv-history","jobs","kelly-sizer","layout-manager","macro-day","market-halts","market-heatmap","market-valuation","members","mna","money-markets","news","openfda","options","options-calculator","options-positioning","options-scenario","pe-band","perps","portfolio-list","power","rate-path","realized-vol","relative-rotation","research","research-search","revenue-breakdown","reverse-dcf","risk-factors","scanner","seasonality","sec","sectors","short-interest","short-volume","social-mentions","supply-chain","ticker-detail","time-sales","treasury-auctions","vol-surface","volatility","world-indices","world-venue-map","yield-curve"],
+  "src/plugins/catalog-browser.ts": ["alerts","analytics","attention","awards","backtest","bond-calculator","catalysts","cds","central-bank-rates","changelog","chart-composer","clinical-trials","cloud","comment-letters","commodities-energy","commodity-balances","company-attention","company-kpis","connections","correlation","cot","cpi","credit-boards","credit-conditions","credit-documents","crypto-board","debt-maturities","dividend-yield","docs","doe","earnings-calls","earnings-ripple","econ","econ-statistics","equity-screener","estimate-revisions","executives","exposure","fear-greed","filing-events","fixed-income","futures","futures-curve","fx-matrix","gpu","help","insider","ipo-calendar","iv-history","jobs","jodi","kelly-sizer","layout-manager","macro-day","market-halts","market-heatmap","market-valuation","members","mna","money-markets","news","openfda","options","options-calculator","options-positioning","options-scenario","pe-band","perps","portfolio-list","power","primary-dealers","rate-path","realized-vol","relative-rotation","research","research-search","revenue-breakdown","reverse-dcf","risk-factors","scanner","seasonality","sec","sectors","short-interest","short-volume","social-mentions","supply-chain","ticker-detail","time-sales","trace-bonds","treasury-auctions","treasury-daily","vol-surface","volatility","world-indices","world-venue-map","yield-curve"],
   "src/plugins/catalog-ui.ts": ["alerts","clinical-trials","cloud","comment-letters","custom-view","fear-greed","ipo-calendar","market-halts","market-heatmap","members","news","notes","openfda","research-search"],
   "src/plugins/catalog.ts": ["debug"],
-  "src/plugins/installer.ts": ["plugin-marketplace"],
-  "src/plugins/manager-node.ts": ["plugin-marketplace"],
   "src/remote/controller.ts": ["custom-view"],
-  "src/renderers/browser/main.tsx": ["plugin-marketplace"],
   "src/renderers/electrobun/bun/core-capabilities.ts": ["notes"],
-  "src/renderers/electrobun/shared/protocol.ts": ["plugin-marketplace"],
   "src/renderers/electrobun/view/cli-pane-shot-entry.tsx": ["econ-statistics","market-valuation","time-sales"],
-  "src/renderers/electrobun/view/main.tsx": ["notes","plugin-marketplace"],
+  "src/renderers/electrobun/view/main.tsx": ["notes"],
   "src/renderers/electrobun/view/remote/connection-health.ts": ["connections"],
-  "src/renderers/opentui/start.tsx": ["plugin-marketplace"],
   "src/sync/core-contributors.ts": ["analytics","portfolio-list"]
 }

package/src/architecture/dom-cell-metrics-allowlist.json

@@ -0,0 +1,28 @@
+{
+  "src/components/layout/pane/header.tsx": 2,
+  "src/components/layout/pane/sizing.ts": 3,
+  "src/components/layout/shell/drag/slide.ts": 4,
+  "src/components/layout/shell/pane/layers.tsx": 6,
+  "src/components/ui/select-button.tsx": 2,
+  "src/renderers/dom/data-table/dom.ts": 26,
+  "src/renderers/dom/data-table/index.tsx": 21,
+  "src/renderers/dom/data-table/row.tsx": 11,
+  "src/renderers/dom/desktop/controls.tsx": 6,
+  "src/renderers/dom/desktop/list-view.tsx": 2,
+  "src/renderers/dom/desktop/popover.tsx": 6,
+  "src/renderers/dom/desktop/query-bar.tsx": 1,
+  "src/renderers/dom/desktop/select-field.tsx": 2,
+  "src/renderers/dom/dom-ui-host.tsx": 6,
+  "src/renderers/dom/host/input.tsx": 5,
+  "src/renderers/dom/host/live-frame.ts": 8,
+  "src/renderers/dom/host/mouse.ts": 10,
+  "src/renderers/dom/host/scroll-box.tsx": 22,
+  "src/renderers/dom/host/size-observer.ts": 6,
+  "src/renderers/dom/host/style.ts": 27,
+  "src/renderers/dom/host/surface-fit.ts": 4,
+  "src/renderers/dom/host/tabs.tsx": 2,
+  "src/renderers/dom/host/text.tsx": 2,
+  "src/renderers/dom/input-host.tsx": 4,
+  "src/renderers/dom/native-renderer.ts": 4,
+  "src/renderers/dom/styles.css": 17
+}

package/src/ask-gloom/pane-context.ts

@@ -0,0 +1,118 @@
+import type { ResolvedPane } from "../layout/pane-manager";
+import type { PluginRegistry } from "../plugins/registry";
+import { panePersonalData } from "../shares/personal-pane";
+import { resolveTickerForPane, type AppState } from "../state/app/context";
+import type { LayoutConfig } from "../types/config";
+import type { PaneSharePrivateFields } from "../types/plugin";
+import type { AskGloomPaneAttachment } from "./pane-request";
+
+/** A handful of the pane's own settings is enough to say how it is set up. */
+const MAX_ARGS = 8;
+const MAX_ARG_KEY_LENGTH = 32;
+const MAX_ARG_VALUE_LENGTH = 48;
+/** Layout and view bookkeeping, not what the pane shows. */
+const BOOKKEEPING_KEYS = [
+  /scroll|width|height|offset|index|expanded|collapsed|focus|hover|sidebar|column|sort|order|version|draft/i,
+  // The cursor's position, but not the symbol it is on.
+  /^cursor(?!Symbol)/,
+  // Timestamps such as `updatedAt`.
+  /[a-z]At$/,
+];
+
+type ArgSource = Readonly<Record<string, unknown>> | undefined;
+
+function isPrivate(fields: PaneSharePrivateFields | undefined, key: string): boolean {
+  return fields === true || (Array.isArray(fields) && fields.includes(key));
+}
+
+function scalarArgs(source: ArgSource, privateFields: PaneSharePrivateFields | undefined): Array<[string, string]> {
+  if (!source || privateFields === true) return [];
+  return Object.entries(source).flatMap(([key, value]): Array<[string, string]> => {
+    if (key.length > MAX_ARG_KEY_LENGTH || BOOKKEEPING_KEYS.some((pattern) => pattern.test(key)) || isPrivate(privateFields, key)) return [];
+    if (typeof value === "number" && Number.isFinite(value)) return [[key, String(value)]];
+    if (typeof value !== "string") return [];
+    const trimmed = value.trim();
+    return trimmed && trimmed.length <= MAX_ARG_VALUE_LENGTH ? [[key, trimmed]] : [];
+  });
+}
+
+/**
+ * The function code a pane is opened by: the one its title starts with when
+ * that opens this pane (a chart opened with `GP` stays `GP`), else the first
+ * template that opens it.
+ */
+function functionCode(registry: Pick<PluginRegistry, "paneTemplates">, paneType: string, title: string): string | null {
+  const prefixes = [...registry.paneTemplates.values()]
+    .filter((template) => template.paneId === paneType && template.shortcut?.prefix)
+    .map((template) => template.shortcut!.prefix.toUpperCase());
+  const token = title.trim().split(/\s+/)[0]?.toUpperCase() ?? "";
+  if (token && prefixes.includes(token)) return token;
+  return prefixes[0] ?? null;
+}
+
+export interface PaneAttachmentSource {
+  registry: Pick<PluginRegistry, "paneTemplates" | "brokers" | "getPanePluginId" | "getBrokerPluginId">;
+  pane: Pick<ResolvedPane, "instance" | "def">;
+  state: AppState;
+  /** The layout the pane is in, as the share path reads it for `personalData`. */
+  layout: LayoutConfig;
+  /** What the header calls it. */
+  title: string;
+  /** The tab each of its tab strips has open, outermost first. */
+  activeTabs?: readonly string[];
+  visibleText: string | null;
+}
+
+/**
+ * What Ask Gloom is told about a pane: its function and arguments as the
+ * user set them, and its text as drawn. Fields the pane keeps to itself when
+ * shared (`portableShare.private`) stay out of its arguments.
+ */
+export function buildAskGloomPaneAttachment({
+  registry,
+  pane,
+  state,
+  layout,
+  title,
+  activeTabs = [],
+  visibleText,
+}: PaneAttachmentSource): AskGloomPaneAttachment {
+  const { instance } = pane;
+  const symbol = resolveTickerForPane(state, instance.instanceId);
+  const paneState = state.paneState[instance.instanceId];
+  const privateFields = pane.def.portableShare?.private;
+  const args: Record<string, string> = {};
+  const tabs = activeTabs.map((tab) => tab.trim()).filter(Boolean);
+  if (tabs.length > 0) args.tab = tabs.join(" > ").slice(0, MAX_ARG_VALUE_LENGTH);
+  for (const [key, value] of [
+    ...scalarArgs(instance.params, privateFields?.params),
+    ...scalarArgs(instance.settings, privateFields?.settings),
+    ...scalarArgs(paneState, privateFields?.state),
+  ]) {
+    if (Object.keys(args).length >= MAX_ARGS) break;
+    if (key in args || value === symbol) continue;
+    args[key] = value;
+  }
+  return {
+    paneId: instance.instanceId,
+    paneType: instance.paneId,
+    title,
+    code: functionCode(registry, instance.paneId, title),
+    symbol,
+    args,
+    visibleText,
+    personal: showsPersonalData({ registry, state, layout, pane }),
+  };
+}
+
+/**
+ * Whatever the pane shows as personal data, as sharing its picture reads it.
+ * A pane that cannot be read for it counts as personal: its contents then wait for a yes.
+ */
+function showsPersonalData(source: Parameters<typeof panePersonalData>[0]): boolean {
+  try {
+    return panePersonalData(source) !== null;
+  } catch {
+    return true;
+  }
+}

package/src/ask-gloom/pane-request.ts

@@ -0,0 +1,70 @@
+/**
+ * Asking Ask Gloom about a pane. Every pane offers it the same way, with no
+ * code of its own: the button beside the `?` in a desktop pane header, Ask
+ * Gloom in the pane menu, and the pane-ask key. The shell describes the pane
+ * here, and Ask Gloom, while its plugin is on, opens a new conversation with
+ * the pane attached.
+ */
+
+/** A pane as Ask Gloom receives it: what it is and what it showed when asked. */
+export interface AskGloomPaneAttachment {
+  /** The pane instance. */
+  paneId: string;
+  /** Its pane type. */
+  paneType: string;
+  /** What its header calls it, such as `DES AAPL`. */
+  title: string;
+  /** The function code that opens it, such as `DES`, when one does. */
+  code: string | null;
+  /** The ticker it shows, when it shows one. */
+  symbol: string | null;
+  /** How it is set up as the user sees it: its tab, range or view. Short values only. */
+  args: Readonly<Record<string, string>>;
+  /** Its text as drawn when asked, bounded; null when none could be read. */
+  visibleText: string | null;
+  /**
+   * The pane shows personal data (`PaneDef.personalData`), so Ask Gloom
+   * asks before anything it shows leaves the device.
+   */
+  personal: boolean;
+}
+
+type AskGloomPaneHandler = (attachment: AskGloomPaneAttachment) => void;
+
+const handlers = new Set<AskGloomPaneHandler>();
+const listeners = new Set<() => void>();
+
+function changed(): void {
+  for (const listener of [...listeners]) listener();
+}
+
+/**
+ * Ask Gloom takes pane questions while it is registered. The shell offers the
+ * button, the menu entry and the key only then, so a profile with the cloud
+ * plugin off shows none of them.
+ */
+export function registerAskGloomPaneHandler(handler: AskGloomPaneHandler): () => void {
+  handlers.add(handler);
+  changed();
+  return () => {
+    if (handlers.delete(handler)) changed();
+  };
+}
+
+export function canAskGloomAboutPanes(): boolean {
+  return handlers.size > 0;
+}
+
+export function subscribeAskGloomAboutPanes(listener: () => void): () => void {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+
+/** Hands the pane to Ask Gloom. False when nothing takes it. */
+export function askGloomAboutPane(attachment: AskGloomPaneAttachment): boolean {
+  if (handlers.size === 0) return false;
+  for (const handler of [...handlers]) handler(attachment);
+  return true;
+}