gloomberb 0.16.3 → 0.16.4

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

@@ -8,6 +8,7 @@ import {
   isPaneDocked,
 } from "../../layout/pane-manager";
 import type { PluginRegistry } from "../../plugins/registry";
+import { PluginOffError, notifyPluginOff } from "../../plugins/plugin-off";
 import { findFixedTickerPaneForSymbol } from "../../layout/ticker-navigation";
 import type { AppAction, AppState } from "../../state/app/context";
 import { TICKER_RESEARCH_PANE_ID, normalizePaneId } from "../../types/config";
@@ -98,10 +99,23 @@ export function useAppTickerOpenRuntime({
     }
   }, [dispatch, pluginRegistry.events, stateRef]);
 
+  /**
+   * A ticker opens in a pane of its plugin, which is added hidden while that
+   * plugin is off, so the open is refused with an offer to turn it on.
+   */
+  const refuseWhileOwnerOff = useCallback((symbol: string, options: PinTickerOptions | undefined, reopen: () => void) => {
+    const paneType = normalizePaneId(options?.paneType ?? TICKER_RESEARCH_PANE_ID);
+    const owner = pluginRegistry.getDisabledPaneOwner(paneType, stateRef.current.config.disabledPlugins);
+    if (!owner) return false;
+    notifyPluginOff(pluginRegistry, new PluginOffError(owner, symbol), reopen);
+    return true;
+  }, [pluginRegistry, stateRef]);
+
   const placePinnedTickerTarget = useCallback((target: TickerOpenTarget, options?: PinTickerOptions) => {
     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;
 
     publishTickerOpenTarget(target);
     const symbol = target.symbol;
@@ -182,10 +196,13 @@ export function useAppTickerOpenRuntime({
     persistLayout,
     pluginRegistry,
     publishTickerOpenTarget,
+    refuseWhileOwnerOff,
     stateRef,
   ]);
 
   const openPinnedTicker = useCallback(async (rawSymbol: string, options?: PinTickerOptions) => {
+    // Before resolving, so a refused open adds no ticker either.
+    if (refuseWhileOwnerOff(rawSymbol, options, () => { void openPinnedTicker(rawSymbol, options); })) return;
     const recordAttention = captureAttentionAction();
     const selectedTicker = options?.instrument !== undefined && (options.instrument || options.listing) ? await tickerRepository.loadTicker(rawSymbol) : null;
     const target = selectedTicker
@@ -197,7 +214,7 @@ export function useAppTickerOpenRuntime({
     if (action && pluginRegistry.panes.has(options?.paneType ?? TICKER_RESEARCH_PANE_ID)) {
       recordAttention(publicTickerKey(target.symbol, target.listing?.exchange ?? target.ticker.metadata.exchange), action);
     }
-  }, [placePinnedTickerTarget, pluginRegistry, resolveOpenTickerTarget, tickerRepository]);
+  }, [placePinnedTickerTarget, pluginRegistry, refuseWhileOwnerOff, resolveOpenTickerTarget, tickerRepository]);
 
   return {
     openPinnedTicker,

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

@@ -15,6 +15,7 @@ import { openTeamPane } from "../../plugins/builtin/cloud/team/pane-request";
 import { chatController } from "../../plugins/builtin/chat/controller";
 import { getShare } from "../../shares/api";
 import { openPaneShare } from "../../shares/pane";
+import { PluginOffError, notifyPluginOff } from "../../plugins/plugin-off";
 import { materializeMarketplaceLayout } from "../../shares/portable-layout";
 
 type CloudDeepLinkRoute = {
@@ -564,6 +565,10 @@ export function handleDesktopDeepLink(rawUrl: string, options: DesktopDeepLinkHa
       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.");
       });
       return;

package/src/app/star-prompt/model.ts

@@ -0,0 +1,98 @@
+import type { StarPromptConfig } from "../../types/config";
+import { isRecord } from "../../utils/guards";
+
+/**
+ * The one-time line in the terminal's status bar asking to star the
+ * repository. It waits for the third distinct day the terminal app is opened
+ * on, then for a minute on screen that day, shows once, and never again:
+ * opening the repository, dismissing it and its timeout all end it, and so
+ * does quitting while it shows. `starPrompt.enabled: false` turns it off.
+ */
+
+export const STAR_PROMPT_REPO_URL = "https://github.com/gloom-sh/gloomberb";
+/** The line waits for this many distinct days of use, today included. */
+const STAR_PROMPT_SESSION_DAYS = 3;
+/** On-screen time on the due day before the line shows. */
+export const STAR_PROMPT_DELAY_MS = 60_000;
+/** On-screen time the line stays before it times out. */
+export const STAR_PROMPT_VISIBLE_MS = 5 * 60_000;
+
+type StarPromptOutcome = NonNullable<StarPromptConfig["outcome"]>;
+
+const DAY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+const OUTCOMES = new Set<StarPromptOutcome>(["opened", "dismissed", "expired"]);
+
+/** The local calendar day of `date`, as `YYYY-MM-DD`. */
+export function localDayKey(date: Date): string {
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  const day = String(date.getDate()).padStart(2, "0");
+  return `${date.getFullYear()}-${month}-${day}`;
+}
+
+function isOff(state: StarPromptConfig | undefined): boolean {
+  return state?.enabled === false || !!state?.shownAt;
+}
+
+/**
+ * Adds `day` to the days of use. Returns the same object when nothing changes:
+ * the line is off or already shown, the day is known, or enough days are.
+ */
+export function recordStarPromptDay(state: StarPromptConfig | undefined, day: string): StarPromptConfig | undefined {
+  if (isOff(state)) return state;
+  const days = state?.days ?? [];
+  if (days.includes(day) || days.length >= STAR_PROMPT_SESSION_DAYS) return state;
+  return { ...state, days: [...days, day] };
+}
+
+/** Whether the line is waiting to show: on, never shown, and used on enough days. */
+export function isStarPromptDue(state: StarPromptConfig | undefined): boolean {
+  return !isOff(state) && (state?.days?.length ?? 0) >= STAR_PROMPT_SESSION_DAYS;
+}
+
+/** Records that the line showed. The days are no longer needed once it has. */
+export function markStarPromptShown(state: StarPromptConfig | undefined, at: Date): StarPromptConfig {
+  const { days: _days, ...rest } = state ?? {};
+  return { ...rest, shownAt: at.toISOString() };
+}
+
+export function finishStarPrompt(state: StarPromptConfig | undefined, outcome: StarPromptOutcome): StarPromptConfig {
+  return { ...state, outcome };
+}
+
+/** Only the fields that hold a valid value survive; an empty object is the same as none. */
+export function sanitizeStarPrompt(value: unknown): StarPromptConfig | undefined {
+  if (!isRecord(value)) return undefined;
+  const days = Array.isArray(value.days)
+    ? [...new Set(value.days.filter((day): day is string => typeof day === "string" && DAY_PATTERN.test(day)))]
+      .slice(0, STAR_PROMPT_SESSION_DAYS)
+    : [];
+  const state: StarPromptConfig = {
+    ...(typeof value.enabled === "boolean" ? { enabled: value.enabled } : {}),
+    ...(days.length > 0 ? { days } : {}),
+    ...(typeof value.shownAt === "string" && value.shownAt ? { shownAt: value.shownAt } : {}),
+    ...(typeof value.outcome === "string" && OUTCOMES.has(value.outcome as StarPromptOutcome)
+      ? { outcome: value.outcome as StarPromptOutcome }
+      : {}),
+  };
+  return Object.keys(state).length > 0 ? state : undefined;
+}
+
+function isSet(value: string | undefined): boolean {
+  const normalized = value?.trim().toLowerCase();
+  return !!normalized && normalized !== "0" && normalized !== "false";
+}
+
+/**
+ * Whether this process is someone sitting at the terminal: both ends of the
+ * terminal are a TTY, and it is neither a CI job nor a test run. Bots, CI,
+ * scripts and smoke runs that pipe the app never see the line.
+ */
+export function starPromptEnvironmentAllows(input: {
+  env: Record<string, string | undefined>;
+  stdinIsTTY: boolean | undefined;
+  stdoutIsTTY: boolean | undefined;
+}): boolean {
+  if (input.stdinIsTTY !== true || input.stdoutIsTTY !== true) return false;
+  if (isSet(input.env.CI)) return false;
+  return input.env.NODE_ENV !== "test";
+}

package/src/app/star-prompt/runtime.ts

@@ -0,0 +1,41 @@
+/**
+ * Off everywhere until the terminal app's entry point allows it, after
+ * `starPromptEnvironmentAllows`: the desktop app, the web terminal, CLI
+ * commands, `shot` and tests never record days or show the line.
+ */
+let allowed = false;
+
+export function allowStarPrompt(value: boolean): void {
+  allowed = value;
+}
+
+export function isStarPromptAllowed(): boolean {
+  return allowed;
+}
+
+interface StarPromptKeyHandlers {
+  open(): void;
+  dismiss(): void;
+}
+
+/** What the notification keys do while the line shows; null otherwise. */
+let keyHandlers: StarPromptKeyHandlers | null = null;
+
+/** Hands the notification keys to the line while it shows; returns the release. */
+export function bindStarPromptKeys(handlers: StarPromptKeyHandlers): () => void {
+  keyHandlers = handlers;
+  return () => {
+    if (keyHandlers === handlers) keyHandlers = null;
+  };
+}
+
+/**
+ * Runs the line's open or dismiss for the notification keys. False when the
+ * line is not showing, so the key goes on to whatever else wants it.
+ */
+export function pressStarPromptKey(kind: "open" | "dismiss"): boolean {
+  if (!keyHandlers) return false;
+  if (kind === "open") keyHandlers.open();
+  else keyHandlers.dismiss();
+  return true;
+}

package/src/app/star-prompt/status-line.tsx

@@ -0,0 +1,190 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+import { Box, Span, Text, useActionShortcut, useRendererHost } from "../../ui";
+import { Button } from "../../components/ui/button";
+import {
+  STATUS_WIDGET_COLUMNS,
+  useStatusWidgetClaim,
+  useStatusWidgetRoom,
+} from "../../components/layout/status-widget-space";
+import { t } from "../../i18n";
+import { useAppLanguage } from "../../i18n/react";
+import { useAppActive } from "../../state/app/activity";
+import { useAppDispatch, useAppGetState, useAppSelector } from "../../state/app/context";
+import { scheduleConfigSave } from "../../state/config-save-scheduler";
+import { useThemeColors } from "../../theme/theme-context";
+import type { StarPromptConfig } from "../../types/config";
+import { displayWidth } from "../../utils/format";
+import {
+  finishStarPrompt,
+  isStarPromptDue,
+  localDayKey,
+  markStarPromptShown,
+  recordStarPromptDay,
+  STAR_PROMPT_DELAY_MS,
+  STAR_PROMPT_REPO_URL,
+  STAR_PROMPT_VISIBLE_MS,
+} from "./model";
+import { bindStarPromptKeys, isStarPromptAllowed } from "./runtime";
+
+/** A session left open past midnight counts the new day too. */
+const DAY_CHECK_INTERVAL_MS = 10 * 60_000;
+const STAR = "★ ";
+/** Between the star action and the dismiss one. */
+const GAP = "  ";
+
+interface StarPromptCopy {
+  lead: string;
+  columns: number;
+}
+
+/**
+ * The longest lead the status bar has room for beside its other widgets, or
+ * null when not even the short one fits; the line then waits for a wider
+ * terminal rather than show cut off.
+ */
+function starPromptCopy(widgetRoom: number, openKey: string, dismissKey: string): StarPromptCopy | null {
+  const spare = widgetRoom - STATUS_WIDGET_COLUMNS;
+  const keys = (openKey ? 1 + displayWidth(openKey) : 0)
+    + GAP.length
+    + 1 + (dismissKey ? 1 + displayWidth(dismissKey) : 0)
+    // The chip padding after the line.
+    + 1;
+  for (const lead of [t("Enjoying Gloomberb? Star it on GitHub"), t("Star on GitHub")]) {
+    const columns = displayWidth(STAR + lead) + keys;
+    if (spare >= columns) return { lead, columns };
+  }
+  return null;
+}
+
+type Phase = "waiting" | "showing" | "done";
+
+interface StarPromptStatusLineProps {
+  delayMs?: number;
+  visibleMs?: number;
+}
+
+/**
+ * One line in the terminal's status bar, once, asking to star the repository:
+ * the notification action key opens it in the browser, the dismiss key or the
+ * × hides it, and it times out on its own. It never takes focus and sits in
+ * the status bar's own row, so it covers nothing. See `./model.ts` for when.
+ */
+export function StarPromptStatusLine(props: StarPromptStatusLineProps) {
+  if (!isStarPromptAllowed()) return null;
+  return <StarPromptLine {...props} />;
+}
+
+function StarPromptLine({ delayMs = STAR_PROMPT_DELAY_MS, visibleMs = STAR_PROMPT_VISIBLE_MS }: StarPromptStatusLineProps) {
+  useAppLanguage();
+  const colors = useThemeColors();
+  const dispatch = useAppDispatch();
+  const getState = useAppGetState();
+  const rendererHost = useRendererHost();
+  const onScreen = useAppActive();
+  const widgetRoom = useStatusWidgetRoom();
+  const openKey = useActionShortcut("notification-action");
+  const dismissKey = useActionShortcut("notification-dismiss");
+  const starPrompt = useAppSelector((state) => state.config.starPrompt);
+  // Days of use count from the first one past setup.
+  const onboarded = useAppSelector((state) => state.config.onboardingComplete === true && !state.config.onboardingProgress);
+  const [phase, setPhase] = useState<Phase>("waiting");
+  const waitedMs = useRef(0);
+  const shownMs = useRef(0);
+  const copy = starPromptCopy(widgetRoom, openKey, dismissKey);
+  const fits = copy !== null;
+  const due = isStarPromptDue(starPrompt);
+
+  const update = useCallback((change: (state: StarPromptConfig | undefined) => StarPromptConfig | undefined) => {
+    const current = getState().config.starPrompt;
+    const next = change(current);
+    if (next === current) return;
+    dispatch({ type: "SET_STAR_PROMPT", starPrompt: next });
+    // Assembled when the write fires, recent tickers included, as the app's own saves are.
+    scheduleConfigSave(() => {
+      const state = getState();
+      return { ...state.config, recentTickers: state.recentTickers };
+    });
+  }, [dispatch, getState]);
+
+  useEffect(() => {
+    if (!onboarded) return;
+    const record = () => update((state) => recordStarPromptDay(state, localDayKey(new Date())));
+    record();
+    const timer = setInterval(record, DAY_CHECK_INTERVAL_MS);
+    return () => clearInterval(timer);
+  }, [onboarded, update]);
+
+  // Counts only time on screen with room for the line, so it never shows to
+  // a terminal in the background or too narrow to read it.
+  useEffect(() => {
+    if (phase !== "waiting" || !due || !onScreen || !fits) return;
+    const startedAt = Date.now();
+    const timer = setTimeout(() => {
+      if (!isStarPromptDue(getState().config.starPrompt)) {
+        setPhase("done");
+        return;
+      }
+      // Recorded as it appears, so quitting while it shows also ends it.
+      update((state) => markStarPromptShown(state, new Date()));
+      setPhase("showing");
+    }, Math.max(0, delayMs - waitedMs.current));
+    return () => {
+      clearTimeout(timer);
+      waitedMs.current += Date.now() - startedAt;
+    };
+  }, [delayMs, due, fits, getState, onScreen, phase, update]);
+
+  const finish = useCallback((outcome: NonNullable<StarPromptConfig["outcome"]>) => {
+    update((state) => finishStarPrompt(state, outcome));
+    setPhase("done");
+  }, [update]);
+  const open = useCallback(() => {
+    void rendererHost.openExternal(STAR_PROMPT_REPO_URL);
+    finish("opened");
+  }, [finish, rendererHost]);
+  const dismiss = useCallback(() => finish("dismissed"), [finish]);
+
+  useEffect(() => {
+    if (phase !== "showing" || !onScreen) return;
+    const startedAt = Date.now();
+    const timer = setTimeout(() => finish("expired"), Math.max(0, visibleMs - shownMs.current));
+    return () => {
+      clearTimeout(timer);
+      shownMs.current += Date.now() - startedAt;
+    };
+  }, [finish, onScreen, phase, visibleMs]);
+
+  const showing = phase === "showing" && fits;
+  useEffect(() => (showing ? bindStarPromptKeys({ open, dismiss }) : undefined), [dismiss, open, showing]);
+  // The version chip gives way to the line.
+  useStatusWidgetClaim("star-prompt", showing && copy ? copy.columns : 0);
+
+  if (!showing || !copy) return null;
+  return (
+    <Box flexDirection="row" flexShrink={0} paddingRight={1} data-gloom-role="star-prompt">
+      <Button
+        label={t("Star Gloomberb on GitHub")}
+        variant="plain"
+        compact
+        shortcut={openKey || undefined}
+        stopPropagation
+        onPress={open}
+      >
+        <Text fg={colors.text}>
+          <Span fg={colors.warning}>{STAR}</Span>
+          {copy.lead}
+        </Text>
+      </Button>
+      <Text>{GAP}</Text>
+      <Button
+        label={t("Dismiss")}
+        displayLabel="×"
+        variant="plain"
+        compact
+        shortcut={dismissKey || undefined}
+        stopPropagation
+        onPress={dismiss}
+      />
+    </Box>
+  );
+}

package/src/app.tsx

@@ -12,6 +12,7 @@ import {
 import { bindAppActivity, useAppActive, useAppVisible } from "./state/app/activity";
 import { Header } from "./components/layout/header";
 import { StatusBar } from "./components/layout/status-bar";
+import { useAppChromeShown } from "./components/layout/presentation";
 import { useLinkedLayoutSync } from "./layout-marketplace/linked-sync";
 import { useTeamCollectionsSync } from "./plugins/builtin/cloud/team/collections-sync";
 import { Shell } from "./components/layout/shell";
@@ -20,6 +21,7 @@ import { TransientLayoutProvider } from "./components/layout/transient-layout";
 import { CommandBar } from "./components/command-bar/surface";
 import { OnboardingWizard } from "./components/onboarding/onboarding-wizard";
 import { CompanyPickerHost } from "./plugins/builtin/cloud/company-picker";
+import { TerminalRelayHost } from "./plugins/builtin/cloud/terminal-relay/host";
 import { SignInGate } from "./components/sign-in-gate";
 import { useDialog } from "./ui/dialog";
 import { PluginRegistry } from "./plugins/registry";
@@ -400,6 +402,7 @@ function AppInner({
     }
   }, [focusedTickerSymbol]);
 
+  const chrome = useAppChromeShown();
   const keybindingHost = useUiHost().kind === "opentui" ? "terminal" : "desktop";
   const keybindings = useResolvedKeybindings(state.config.keybindings, keybindingHost);
   useAppGlobalShortcuts({
@@ -451,13 +454,15 @@ function AppInner({
         desktopWindowBridge={desktopWindowBridge}
       >
         <ThemedAppRoot>
-          <Header
-            onOpenHelp={() => {
-              recordFunctionOpen({ shortcut: "HELP", externalPluginId: null });
-              pluginRegistry.showPane("help");
-            }}
-            onRestartForUpdate={updatesEnabled && !isDetachedWindow ? restartToApplyUpdate : undefined}
-          />
+          {chrome.header && (
+            <Header
+              onOpenHelp={() => {
+                recordFunctionOpen({ shortcut: "HELP", externalPluginId: null });
+                pluginRegistry.showPane("help");
+              }}
+              onRestartForUpdate={updatesEnabled && !isDetachedWindow ? restartToApplyUpdate : undefined}
+            />
+          )}
           <TransientLayoutProvider>
             <Shell
               pluginRegistry={pluginRegistry}
@@ -476,6 +481,7 @@ function AppInner({
             />
           </TransientLayoutProvider>
           {!onboardingActive ? <CompanyPickerHost pluginRegistry={pluginRegistry} /> : null}
+          <TerminalRelayHost device={remoteControlAdapter?.terminalDevice} />
           {onboardingActive && onOnboardingComplete ? (
             <OnboardingWizard
               pluginRegistry={pluginRegistry}

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

@@ -0,0 +1,70 @@
+{
+  "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/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/brokers/signed-in/sign-in-dialog.tsx": ["cloud"],
+  "src/cli/commands/market.ts": ["holders","research","sec"],
+  "src/cli/commands/options-chain.ts": ["options","options-calculator"],
+  "src/cli/commands/options-leaps.ts": ["options","vol-surface"],
+  "src/cli/commands/overview.ts": ["correlation","econ","market-movers","sectors","world-indices"],
+  "src/cli/commands/ticker.ts": ["notes","portfolio-list"],
+  "src/cli/desktop-pane-shot.ts": ["market-valuation","time-sales"],
+  "src/cli/pane-functions/data.ts": ["chart-composer","correlation","seasonality","ticker-detail"],
+  "src/cli/pane-functions/financial-ratio-shot.ts": ["ticker-detail"],
+  "src/cli/pane-functions/headless.ts": ["portfolio-list"],
+  "src/cli/pane-functions/options.ts": ["ticker-detail"],
+  "src/cli/pane-functions/resolver.ts": ["chart-composer"],
+  "src/cli/pane-functions/screenshot-evidence.ts": ["attention","awards","catalysts","company-attention","company-kpis","credit-documents","exposure","market-heatmap","options-calculator","options-scenario","power","realized-vol","supply-chain","vol-surface","volatility","world-venue-map"],
+  "src/cli/pane-functions/screenshot.ts": ["chart-composer","econ-statistics","market-valuation","portfolio-list","ticker-detail","time-sales"],
+  "src/components/command-bar/commands/collection.ts": ["portfolio-list"],
+  "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"],
+  "src/components/command-bar/workflow/ops.ts": ["correlation","portfolio-list","ticker-detail"],
+  "src/components/command-bar/workflow/tickers.ts": ["portfolio-list"],
+  "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/account-step/form-panel.tsx": ["cloud"],
+  "src/components/onboarding/account-step/index.tsx": ["cloud"],
+  "src/components/onboarding/account-step/qr-panel.tsx": ["cloud"],
+  "src/components/onboarding/account-step/signed-in-panel.tsx": ["cloud"],
+  "src/components/onboarding/onboarding-keyboard.ts": ["account-management"],
+  "src/components/onboarding/onboarding-wizard.tsx": ["account-management","cloud"],
+  "src/components/onboarding/use-onboarding-upgrade.ts": ["account-management","chat","cloud"],
+  "src/components/onboarding/wizard-account.ts": ["cloud"],
+  "src/components/onboarding/wizard-model.ts": ["portfolio-list"],
+  "src/components/onboarding/wizard-positions.ts": ["portfolio-list"],
+  "src/components/sign-in-gate.tsx": ["cloud"],
+  "src/layout-marketplace/gallery.tsx": ["cloud","plugin-marketplace"],
+  "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","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/remote/connection-health.ts": ["connections"],
+  "src/renderers/opentui/start.tsx": ["plugin-marketplace"],
+  "src/sync/core-contributors.ts": ["analytics","portfolio-list"]
+}

package/src/brokers/signed-in/adapter.ts

@@ -23,11 +23,38 @@ import { SIGNED_IN_BROKER_TYPE, signedInBrokerId } from "./profile";
 
 const METHOD = "Sign in";
 
+/**
+ * The message Gloom wrote for the client. The request error's own `message`
+ * has the error code appended to it, so this reads the body's field first.
+ */
+function writtenMessage(error: ApiRequestError): string | null {
+  const written = error.details?.message;
+  if (typeof written === "string" && written.trim()) return written.trim();
+  const { message, code } = error;
+  const text = code && message.endsWith(` ${code}`) ? message.slice(0, -(code.length + 1)) : message;
+  return text.trim() || null;
+}
+
+/**
+ * Why the broker ended a sign-in, as Gloom stores it, without the OAuth code
+ * in front: "invalid_grant: Authorization grant has expired" reads
+ * "Authorization grant has expired".
+ */
+function brokerReason(lastError: string | null | undefined): string | null {
+  const text = lastError?.trim();
+  if (!text) return null;
+  const described = /^[a-z_]+:\s*(\S[\s\S]*)$/.exec(text)?.[1] ?? text;
+  return described.replace(/[\s.]+$/, "").slice(0, 200) || null;
+}
+
 /** What to tell the user when Gloom answers a broker call with an error. */
 function describeSignedInBrokerError(error: unknown, brokerName: string): string {
   const status = error instanceof ApiRequestError ? error.status : undefined;
   if (status === 401) return `Sign in to Gloom first, then connect ${brokerName}.`;
-  if (status === 404 || status === 409) return `${brokerName} needs you to sign in again. Press Connect in Brokers.`;
+  const signInAgain = `${brokerName} needs you to sign in again. Press Connect in Brokers.`;
+  // A sign-in the broker ended says why, in Gloom's words.
+  if (status === 409) return (error instanceof ApiRequestError && writtenMessage(error)) || signInAgain;
+  if (status === 404) return signInAgain;
   if (status === 502) return `${brokerName} is not responding. Try again shortly.`;
   return error instanceof Error && error.message ? error.message : String(error);
 }
@@ -215,7 +242,11 @@ export function createSignedInBrokerAdapter(overrides: Partial<SignedInBrokerAda
       await track(instance, async () => {
         const connection = await get<SignedInBrokerConnection>(instance, "");
         if (connection.status !== "connected") {
-          throw new Error(`Press Connect in Brokers to sign in to ${brokerName(instance)}.`);
+          const name = brokerName(instance);
+          const reason = brokerReason(connection.lastError);
+          throw new Error(reason
+            ? `${name} needs you to sign in again: ${reason}. Press Connect in Brokers.`
+            : `Press Connect in Brokers to sign in to ${name}.`);
         }
       });
     },

package/src/brokers/signed-in/client.ts

@@ -31,6 +31,16 @@ export interface SignedInBrokerConnection {
   connectedAt: string | null;
   refreshedAt: string | null;
   syncedAt: string | null;
+  /**
+   * When the broker ends this sign-in on its own clock, however often it was
+   * refreshed. Set only while connected and only for a broker that does so.
+   * The three fields below are absent from a Gloom server that predates them.
+   */
+  expiresAt?: string | null;
+  /** Within a day of `expiresAt`, or past it: time to connect again. */
+  expiresSoon?: boolean;
+  /** Why the broker ended the sign-in, in its own words. Null while connected. */
+  lastError?: string | null;
 }
 
 /** Public: the list does not depend on the user, so Add Broker can show it signed out. */