gloomberb 0.16.5 → 0.16.6

package/src/app/global-shortcuts.ts

@@ -1,4 +1,4 @@
-import { useEffect, useRef, type Dispatch } from "react";
+import { useEffect, useRef, useState, type Dispatch } from "react";
 import { useShortcut } from "../react/input";
 import { useNativeRenderer, useRendererHost, useUiHost } from "../ui";
 import { useDialogState } from "../ui/dialog";
@@ -13,6 +13,7 @@ import { getVisiblePaneCycleOrder } from "../components/layout/pane/cycle-order"
 import { requestFunctionHelp, useFunctionHelpHost } from "../plugins/builtin/help/function-card";
 import { buildRegistryHelpIndex, helpFunctionForPane } from "../plugins/builtin/help/function-index";
 import { recordFunctionOpen } from "../telemetry/usage-counts";
+import { createOneShots } from "../utils/one-shot";
 import { DOCS_PANE_TEMPLATE_ID } from "../docs/content";
 import { registerPaneDocsHandler } from "../docs/requests";
 import { isMoveDownShortcut, isMoveUpShortcut } from "../components/command-bar/keyboard-handlers";
@@ -117,6 +118,10 @@ export function useAppGlobalShortcuts({
   const uiKind = useUiHost().kind;
   const toastHost = useToastHost();
   useKeybindingIssueNotice(keybindings, pluginRegistry, state.initialized);
+  // Every action here runs once per press: a held key, or a terminal that does
+  // not say it is a repeat, must not run it again. Only moving focus between
+  // panes (Tab) and switching layouts by number (idempotent) are left to repeat.
+  const [shots] = useState(createOneShots);
   useFunctionHelpHost({
     closeCommandBar: () => {
       if (state.commandBarOpen) dispatch({ type: "SET_COMMAND_BAR", open: false });
@@ -149,6 +154,23 @@ export function useAppGlobalShortcuts({
 
     const match = matchKeybinding(keybindings, event);
     const action = match?.kind === "action" ? match.id : null;
+    /**
+     * Whether the action already ran for this press or hold. An action that
+     * takes the key (`claims`) swallows the refused ones as well; one that
+     * leaves it to the pane (R) does not, so a pane's own key keeps working.
+     */
+    const ranAlready = (id: string, claims = true): boolean => {
+      const shot = shots.get(id);
+      if (shot.refuses(event)) {
+        if (claims) {
+          event.preventDefault();
+          event.stopPropagation();
+        }
+        return true;
+      }
+      shot.end();
+      return false;
+    };
 
     // Terminals send Ctrl; the browser and the desktop webview send Cmd on
     // macOS, which the OpenTUI host also reports as `super` under the kitty
@@ -172,6 +194,7 @@ export function useAppGlobalShortcuts({
     // The status bar's star line answers the same keys once no toast does,
     // but only over the workspace itself.
     if (action === "notification-action" || action === "notification-dismiss") {
+      if (ranAlready(action)) return;
       const toastHandled = action === "notification-action"
         ? toastHost.activateNewest?.() === true
         : toastHost.dismissNewest?.() === true;
@@ -195,12 +218,14 @@ export function useAppGlobalShortcuts({
       // Ctrl+P and Ctrl+N move the open bar's selection, so a bar chord that
       // is one of them only opens it; Esc and the bar's other chords close it.
       if (state.commandBarOpen && (isMoveUpShortcut(event) || isMoveDownShortcut(event))) return;
+      if (ranAlready(action)) return;
       event.preventDefault();
       event.stopPropagation();
       dispatch({ type: "TOGGLE_COMMAND_BAR" });
       return;
     }
     if (!isDetachedWindow && action === "ticker-search" && !state.commandBarOpen) {
+      if (ranAlready(action)) return;
       event.preventDefault();
       event.stopPropagation();
       dispatch({
@@ -233,6 +258,7 @@ export function useAppGlobalShortcuts({
       // Command and function keys are never text, so they still fire.
       const editing = state.inputCaptured || event.targetEditable === true;
       if (editing && event.ctrl && !(event.meta || event.super)) return;
+      if (ranAlready(`command:${match.command.query}`)) return;
       event.preventDefault();
       event.stopPropagation();
       dispatch({
@@ -246,6 +272,7 @@ export function useAppGlobalShortcuts({
 
     // A function key is never text, so the card opens from a focused field too.
     if (action === "function-help") {
+      if (ranAlready(action)) return;
       event.preventDefault();
       event.stopPropagation();
       recordFunctionOpen({ shortcut: "HELP", externalPluginId: null });
@@ -259,6 +286,7 @@ export function useAppGlobalShortcuts({
     if (state.inputCaptured) return;
 
     if (!isDetachedWindow && action === "help") {
+      if (ranAlready(action)) return;
       event.preventDefault();
       event.stopPropagation();
       pluginRegistry.showPane("help");
@@ -266,13 +294,16 @@ export function useAppGlobalShortcuts({
     }
 
     if (!isDetachedWindow && action === "quit") {
+      if (ranAlready(action, false)) return;
       if (uiKind === "opentui") rendererHost.requestExit();
     } else if (action === "refresh-ticker") {
+      if (ranAlready(action, false)) return;
       if (focusedTickerSymbol) {
         const ticker = state.tickers.get(focusedTickerSymbol);
         if (ticker) refreshTicker(ticker.metadata.ticker, ticker.metadata.exchange, ticker, 0);
       }
     } else if (action === "refresh-all") {
+      if (ranAlready(action, false)) return;
       for (const ticker of state.tickers.values()) {
         refreshTicker(ticker.metadata.ticker, ticker.metadata.exchange, ticker, 1);
       }
@@ -280,10 +311,12 @@ export function useAppGlobalShortcuts({
       // A release that can install itself downloads on its own, so the key is
       // for the one that waits for a restart and for the one that failed.
       if (!isDetachedWindow && canRestartToApply(state.updateProgress)) {
+        if (ranAlready(action)) return;
         event.preventDefault();
         event.stopPropagation();
         restartToApplyUpdate();
       } else if (canRetryUpdate(state)) {
+        if (ranAlready(action)) return;
         event.preventDefault();
         event.stopPropagation();
         startUpdate(state.updateAvailable!);
@@ -296,6 +329,7 @@ export function useAppGlobalShortcuts({
         if (ownerId && disabledPlugins.has(ownerId)) continue;
         const chords = resolvePluginShortcutChords(keybindingsConfig, shortcut);
         if (chords.some((chord) => matchesKeyChord(chord, event))) {
+          if (ranAlready(`plugin:${shortcut.id}`, false)) return;
           shortcut.execute();
           break;
         }

package/src/app/keybindings/actions.ts

@@ -28,6 +28,7 @@ export type CoreKeybindingActionId =
   | "pane-screenshot"
   | "pane-export-csv"
   | "pane-share"
+  | "pane-ask"
   | "layout-gallery"
   | "tidy-windows"
   | "window-move-mode"
@@ -59,6 +60,7 @@ export const PANE_ACTION_IDS = new Set<CoreKeybindingActionId>([
   "pane-screenshot",
   "pane-export-csv",
   "pane-share",
+  "pane-ask",
   "layout-gallery",
   "tidy-windows",
   "window-move-mode",
@@ -225,9 +227,18 @@ export const KEYBINDING_ACTIONS: readonly KeybindingActionDef[] = [
   {
     id: "pane-share",
     category: "Pane Management",
-    description: "Share the focused pane.",
+    description: "Share the focused pane: post a picture to chat or copy its link.",
     defaults: ["CmdOrCtrl+Shift+S"],
   },
+  {
+    id: "pane-ask",
+    category: "Pane Management",
+    description: "Ask Gloom about the focused pane, in a new conversation with the pane attached.",
+    // A for ask. Alt+A first, because it reaches most terminals, where
+    // Ctrl+Shift+A is often the terminal's own select all; the desktop app
+    // advertises the chord on its platform modifier.
+    defaults: ["Alt+A", "CmdOrCtrl+Shift+A"],
+  },
   {
     id: "layout-gallery",
     category: "Pane Management",

package/src/app/pane-runtime/plugin-bindings.ts

@@ -16,8 +16,8 @@ import {
 } from "../../components/layout/shell/visible-layout";
 import { applyPluginToggles } from "../../plugins/ownership";
 import { setLayoutManagerDispatch } from "../../plugins/builtin/layout-manager";
-import { setMarketplaceHost } from "../../plugins/builtin/plugin-marketplace/store";
-import type { InstalledPlugin } from "../../plugins/builtin/plugin-marketplace/model";
+import { setMarketplaceHost } from "../../plugins/marketplace/store";
+import type { InstalledPlugin } from "../../plugins/marketplace/model";
 import {
   listExternalPlugins,
   removeExternalPlugin,

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

@@ -17,6 +17,7 @@ import { getShare } from "../../shares/api";
 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 +476,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;
   }
 

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-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/ask-gloom/pane-context.ts

@@ -0,0 +1,114 @@
+import type { PluginRegistry } from "../plugins/registry";
+import { paneShowsPersonalData } from "../shares/personal-pane";
+import type { AppConfig, PaneInstanceConfig } from "../types/config";
+import type { PaneSharePrivateFields } from "../types/plugin";
+import type { TickerRecord } from "../types/ticker";
+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, "panes" | "paneTemplates" | "brokers" | "getPanePluginId" | "getBrokerPluginId">;
+  instance: PaneInstanceConfig;
+  /** What the header calls it. */
+  title: string;
+  symbol: string | null;
+  paneState?: Readonly<Record<string, unknown>>;
+  config: Pick<AppConfig, "portfolios" | "brokerInstances">;
+  tickers?: ReadonlyMap<string, TickerRecord>;
+  /** 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,
+  instance,
+  title,
+  symbol,
+  paneState,
+  config,
+  tickers,
+  activeTabs = [],
+  visibleText,
+}: PaneAttachmentSource): AskGloomPaneAttachment {
+  const privateFields = registry.panes.get(instance.paneId)?.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, instance, paneState, symbol, config, tickers }),
+  };
+}
+
+/** A pane that cannot be read for it counts as personal: its contents then wait for a yes. */
+function showsPersonalData(source: Parameters<typeof paneShowsPersonalData>[0]): boolean {
+  try {
+    return paneShowsPersonalData(source);
+  } 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;
+  /**
+   * It shows holdings, balances or account data, 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;
+}