gloomberb 0.18.0 → 0.18.2

package/src/plugins/builtin/ticker-detail/pane.tsx

@@ -39,6 +39,7 @@ import { ResearchTabKeysProvider, useResearchTabKeysHost } from "./research-tab-
 import { ResearchTabNavigationProvider } from "./research-tab-navigation";
 import { usePluginAppActions } from "../../../public/react";
 import { resolveTickerInstrumentKind } from "../../../tickers/instrument-kind";
+import { ResearchTradeWorkspace } from "../broker-trading/dock";
 
 const TICKER_RESEARCH_TAB_COMMIT_DELAY_MS = 120;
 /** A tab counts as viewed once it stays open this long, not when h/l passes over it. */
@@ -207,7 +208,9 @@ export function TickerResearchPane({ focused, width, height }: PaneProps) {
   const quoteFooterActive = resolvedTabId === "overview" || resolvedTabId === "chart";
   const cloudAccess = useCloudAccessFooter({
     delayLabel: tf("{count}m", { count: CLOUD_QUOTE_DELAY_MINUTES }),
-    degraded: financials?.quote?.priceObservation !== "nav" && financials?.quote?.dataSource !== "live",
+    // A listing that no longer trades has no delay to speak of: its quote is its last session's close.
+    degraded: !financials?.quote?.delisting && financials?.quote?.priceObservation !== "nav"
+      && financials?.quote?.dataSource !== "live",
     focused: focused && quoteFooterActive,
     segmentId: "ticker-research-access",
     shortcutScope: "ticker-research:upgrade",
@@ -359,16 +362,14 @@ export function TickerResearchPane({ focused, width, height }: PaneProps) {
     );
   }
 
-  return (
-    <Box flexDirection="column" flexGrow={1} flexBasis={0} overflow="hidden">
-      {tabStrip}
-
-      <Box height={contentHeight} flexGrow={1} flexBasis={0} overflow="hidden">
-        <ResearchTabKeysProvider value={showTabs ? researchTabKeys.value : null}>
+  const tradeAvailable = visibleTabIds.has("broker-trade");
+  // Trade shows Chart beside its ticket: the workspace names the tab it shows.
+  const renderTabs = (contentWidth: number, contentFocused: boolean, shownTabId = resolvedTabId) => (
+    <ResearchTabKeysProvider value={showTabs ? researchTabKeys.value : null}>
           {tickerResearchTabs.map((tab) => {
-            if (!renderedTabIds.has(tab.id) || !visibleTabIds.has(tab.id)) return null;
+            if (tradeAvailable && tab.id === "broker-trade" || !(renderedTabIds.has(tab.id) || tab.id === shownTabId) || !visibleTabIds.has(tab.id)) return null;
             const TickerResearchTab = tab.component;
-            const isActive = resolvedTabId === tab.id;
+            const isActive = shownTabId === tab.id;
             return (
               <Box
                 key={tab.id}
@@ -383,9 +384,9 @@ export function TickerResearchPane({ focused, width, height }: PaneProps) {
                   <NestedPaneTabs>
                     <ResearchTabNavigationProvider value={showTabs ? openResearchTab : null}>
                       <TickerResearchTab
-                        width={width}
+                        width={contentWidth}
                         height={contentHeight}
-                        focused={focused && isActive}
+                        focused={contentFocused && isActive}
                         onCapture={isActive ? handlePluginCapture : ignorePluginCapture}
                       />
                     </ResearchTabNavigationProvider>
@@ -394,8 +395,14 @@ export function TickerResearchPane({ focused, width, height }: PaneProps) {
               </Box>
             );
           })}
-        </ResearchTabKeysProvider>
-      </Box>
-    </Box>
+    </ResearchTabKeysProvider>
   );
+  return <Box flexDirection="column" flexGrow={1} flexBasis={0} overflow="hidden">
+    {tabStrip}
+    <Box height={contentHeight} flexGrow={1} flexBasis={0} overflow="hidden">
+      {tradeAvailable ? <ResearchTradeWorkspace width={width} height={contentHeight} focused={focused} symbol={ticker.metadata.ticker}
+        tabId={resolvedTabId} selectTab={selectResearchTab} onCapture={handlePluginCapture} locked={!!paneSettings.hideTabs}>{renderTabs}</ResearchTradeWorkspace>
+        : renderTabs(width, focused)}
+    </Box>
+  </Box>;
 }

package/src/plugins/builtin/ticker-detail/quote-footer.ts

@@ -2,6 +2,7 @@ import type { PaneFooterSegment } from "../../../components/layout/pane/footer";
 import { t } from "../../../i18n";
 import { isQuoteStaleForCurrentSession } from "../../../market-data/quotes/freshness";
 import { formatQuoteNavAsOf } from "../../../market-data/quotes/time";
+import { delistingLabel } from "../../../market-data/quotes/delisting";
 import type { Quote } from "../../../types/financials";
 import { displayWidth } from "../../../utils/format";
 
@@ -12,7 +13,10 @@ export function tickerQuoteFooterInfo(
 ): PaneFooterSegment[] {
   const info: PaneFooterSegment[] = [];
   const navAsOf = formatQuoteNavAsOf(quote);
-  if (isQuoteStaleForCurrentSession(quote)) {
+  if (quote?.delisting) {
+    // A listing that no longer trades: its quote is its last trade, said once with its date.
+    info.push({ id: "ticker-research-stale", parts: [{ text: delistingLabel(quote.delisting), tone: "warning" }] });
+  } else if (isQuoteStaleForCurrentSession(quote)) {
     const status: PaneFooterSegment = { id: "ticker-research-stale", parts: [{ text: t("Stale quote"), tone: "warning" }] };
     const timestamp = new Date(quote!.lastUpdated);
     if (navAsOf) {

package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx

@@ -20,6 +20,7 @@ import {
 } from "../../../../market-data/market/status";
 import { t } from "../../../../i18n";
 import { isQuoteStaleForCurrentSession } from "../../../../market-data/quotes/freshness";
+import { delistingLabel, delistingStateLabel } from "../../../../market-data/quotes/delisting";
 import { formatQuoteNavAsOf } from "../../../../market-data/quotes/time";
 import { useQuoteFlashDirection } from "../../../../components/quote-flash";
 import { followLiveSparklinePrice } from "../../../../components/price-sparkline/model";
@@ -89,6 +90,8 @@ interface QuoteStatus {
   failed: boolean;
   text: string;
   stale?: boolean;
+  /** DELISTED or INACTIVE: the listing no longer trades, and `text` says since when. */
+  ended?: string;
 }
 
 function resolveQuoteStatus(entry: QueryEntry<Quote> | null, symbol: string, quote: Quote | null | undefined): QuoteStatus {
@@ -98,6 +101,7 @@ function resolveQuoteStatus(entry: QueryEntry<Quote> | null, symbol: string, quo
       ? { failed: true, text: `${symbol} not recognized` }
       : { failed: true, text: error.message || "Quote unavailable" };
   }
+  if (quote?.delisting) return { failed: true, text: delistingLabel(quote.delisting), stale: true, ended: delistingStateLabel(quote.delisting) };
   if (isQuoteStaleForCurrentSession(quote)) return { failed: true, text: "Stale quote", stale: true };
   if (entry?.phase === "ready") return { failed: false, text: "No quote data" };
   return { failed: false, text: "Loading quote..." };
@@ -175,8 +179,9 @@ export function QuoteMonitorCard({
   // One decimal count per instrument, so streamed ticks never narrow or widen the price column.
   const priceOptions = liveQuoteFormatOptions(quote, currency, assetCategory, cachedFinancials?.quoteMetadata?.instrumentType);
   const priceText = display ? formatMarketPriceWithCurrency(display.price, currency, priceOptions) : "";
-  const changePercentText = display ? formatPercentRaw(display.changePercent) : "";
-  const changeValueText = display ? formatSignedMarketPrice(display.change, priceOptions) : "";
+  // A listing that no longer trades shows its last close alone: no move, not even a dash for one.
+  const changePercentText = display && !quote?.delisting ? formatPercentRaw(display.changePercent) : "";
+  const changeValueText = display && !quote?.delisting ? formatSignedMarketPrice(display.change, priceOptions) : "";
   const priceColumnWidth = Math.max(priceText.length, changePercentText.length + changeValueText.length + 1);
   const nameMaxWidth = Math.max(10, width - priceColumnWidth - (nativePaneChrome ? 5 : 3));
   // The terminal sets the line beside the change, under the symbol (or after it in a
@@ -187,6 +192,8 @@ export function QuoteMonitorCard({
   const extendedParts = display && extended
     ? extendedLineParts(extended, formatMarketPriceWithCurrency(extended.price, currency, priceOptions), (text) => displayWidth(text) <= extendedRoom)
     : null;
+  // A desktop card says a listing no longer trades on a row of its own.
+  const endedRow = nativePaneChrome && quoteFailed && !!quoteStatus.ended && !extendedParts;
   const extendedColor = quoteFailed ? colors.textDim : priceColor(extended?.change ?? 0);
   const extendedDim = !!flashDirection && headlineHolds;
   const sparklineRange = resolvePriceSparklineRange(priceHistory, chartPeriod);
@@ -254,7 +261,7 @@ export function QuoteMonitorCard({
           <Text attributes={TextAttributes.BOLD} fg={symbolFg} bg={symbolBg} style={desktopSymbolStyle}>
             {symbol}
           </Text>
-          <Text fg={quoteStatus.failed ? colors.negative : colors.textDim}>{quoteStatus.text}</Text>
+          <Text fg={quoteStatus.ended ? colors.warning : quoteStatus.failed ? colors.negative : colors.textDim}>{quoteStatus.text}</Text>
         </Box>
       ) : nativePaneChrome ? (
         <Box
@@ -276,7 +283,7 @@ export function QuoteMonitorCard({
             minWidth={0}
             style={{
               gridColumn: "1",
-              gridRow: extendedParts ? "1" : "1 / span 2",
+              gridRow: extendedParts || endedRow ? "1" : "1 / span 2",
               minWidth: 0,
               overflow: "hidden",
             }}
@@ -284,8 +291,8 @@ export function QuoteMonitorCard({
             <Text attributes={TextAttributes.BOLD} fg={symbolFg} bg={symbolBg} style={desktopSymbolStyle}>
               {symbol}
             </Text>
-            {quoteFailed && (
-              <Text fg={colors.negative} style={{ fontSize: "var(--gloom-type-ui)", lineHeight: "14px" }}>
+            {quoteFailed && !endedRow && (
+              <Text fg={quoteStatus.ended ? colors.warning : colors.negative} style={{ fontSize: "var(--gloom-type-ui)", lineHeight: "14px" }}>
                 {quoteStatus.text}
               </Text>
             )}
@@ -332,6 +339,28 @@ export function QuoteMonitorCard({
             </Box>
           </Box>
 
+          {endedRow && (
+            // Under the price, across the card, so the date is never cut on a narrow card;
+            // backed like the price so the sparkline does not run through it.
+            <Text
+              fg={colors.warning}
+              style={{
+                gridColumn: "1 / -1",
+                gridRow: "2",
+                justifySelf: "start",
+                alignSelf: "start",
+                fontSize: "var(--gloom-type-ui)",
+                lineHeight: "14px",
+                whiteSpace: "nowrap",
+                backgroundColor: colors.bg,
+                borderRadius: "var(--gloom-radius-sm)",
+                boxShadow: `0 0 0 2px ${colors.bg}`,
+              }}
+            >
+              {quoteStatus.text}
+            </Text>
+          )}
+
           {extendedParts && (
             <ExtendedSessionLine
               parts={extendedParts}
@@ -385,7 +414,7 @@ export function QuoteMonitorCard({
               </Box>
               <Box flexDirection="column">
                 <FigureText fg={changeColor} dim={flashing} style={figureHalo}>
-                  {compactQuoteFailure ? `${priceText} · ${quoteStatus.stale ? "STALE" : "ERROR"}` : priceText}
+                  {compactQuoteFailure ? `${priceText} · ${quoteStatus.ended ?? (quoteStatus.stale ? "STALE" : "ERROR")}` : priceText}
                 </FigureText>
                 <Box flexDirection="row" gap={1}>
                   <FigureText part="sub" fg={changeColor} dim={flashing} style={figureHalo}>{changePercentText}</FigureText>
@@ -432,7 +461,7 @@ export function QuoteMonitorCard({
           )}
 
           {quoteFailed && !compactQuoteFailure && (
-            <Box height={1} overflow="hidden"><Text fg={colors.negative}>{quoteStatus.text}</Text></Box>
+            <Box height={1} overflow="hidden"><Text fg={quoteStatus.ended ? colors.warning : colors.negative}>{quoteStatus.text}</Text></Box>
           )}
           {navAsOf && !compactNavAsOf && (
             <Box height={1} overflow="hidden"><Text fg={colors.textDim}>{navAsOf}</Text></Box>

package/src/plugins/builtin/time-sales/pane.tsx

@@ -1,7 +1,7 @@
 import { useEffect, useMemo, useRef, useState } from "react";
 import { Box } from "../../../ui";
 import { usePaneSettingValue, useShortcut } from "../../../public/react";
-import { DataTableStackView, KeyValueRow, PaneStatusBody, StatGrid, usePaneFooter, usePaneNoticeFooter, usePaneStatusFooter, usePaneTabs, usePaneTicker, type DataTableColumn } from "../../../components";
+import { splitDelayedStatus, DataTableStackView, KeyValueRow, PaneStatusBody, StatGrid, usePaneFooter, usePaneNoticeFooter, usePaneStatusFooter, usePaneTabs, usePaneTicker, type DataTableColumn } from "../../../components";
 import { useThemeColors } from "../../../theme/theme-context";
 import type { PaneProps } from "../../../types/plugin";
 import type { TapeQuote, TapeSnapshot, TapeTrade } from "../../../api-client/tape";
@@ -109,7 +109,7 @@ function TimeSalesView({ width, height, focused, symbol, exchange }: PaneProps &
   usePaneNoticeFooter({ registrationId: "time-sales:notices", focused, notices: [...(data?.gaps ?? []), ...(resource.transport ? [resource.transport] : []),
     ...(pinnedBeforeTape ? [`The pinned moment is before this tape's first ${tab === "quotes" ? "quote" : "print"}, ${tapeStampNewYork(rowTime(rows.at(-1)!))}.`] : [])] });
   usePaneStatusFooter({ registrationId: "time-sales:status", loading: resource.loading, error: resource.error,
-    info: data ? [{ id: "feed", quoteStatus: true, parts: [{ text: `${data.feed === "sip" ? "real-time" : "15m delayed"} · ${tapeStampNewYork(data.asOf)}`, tone: "muted" }] },
+    info: data ? [...splitDelayedStatus({ id: "feed", quoteStatus: true, parts: [{ text: `${data.feed === "sip" ? "real-time" : "15m delayed"} · ${tapeStampNewYork(data.asOf)}`, tone: "muted" }] }),
       ...(frozen ? [{ id: "paused", parts: [{ text: "paused", tone: "warning" as const }] }] : []),
       ...(!data.connected || resource.snapshotOnly ? [{ id: "snapshot", parts: [{ text: "snapshot", tone: "warning" as const }] }] : [])] : [] });
   const selectTab = (value: string) => { setTab(value); setDetail(null); setSelected(null); };

package/src/plugins/builtin/trace-bonds/client.ts

@@ -4,6 +4,7 @@ import { signalWithTimeout } from "../../../utils/async-deadline";
 import { parsePublicTickerKey } from "../../../utils/exchanges";
 import { httpFetch } from "../../../utils/http-transport";
 import { isoDateOrNull, numericOrNull, recordOrNull, textOrNull } from "../../../utils/guards";
+import { logFailure } from "../../../utils/log-failure";
 import { zonedDateKey } from "../../../utils/zoned-date-time";
 
 const ENDPOINT = "https://services-dynarep.ddwa.finra.org/public/reporting/v2/data/group/FixedIncomeMarket/name/corporateAndAgencySecurities";
@@ -226,6 +227,7 @@ function dataRows(data: unknown): unknown[] | null {
     const parsed = JSON.parse(data) as unknown;
     return Array.isArray(parsed) ? parsed : null;
   } catch {
+    // Intentional ignore: malformed nested rows make postBondPage reject the response shape.
     return null;
   }
 }
@@ -340,7 +342,9 @@ async function readPayload(response: Response): Promise<unknown> {
 async function openSession(signal: AbortSignal): Promise<string> {
   const session = await httpFetch(ENDPOINT, { headers: REQUEST_HEADERS, signal });
   const token = xsrfToken(session);
-  await session.body?.cancel().catch(() => {});
+  await session.body?.cancel().catch(() => {
+    // Intentional ignore: only session headers are needed; discarding its unused body is best effort.
+  });
   if (!token) throw new Error(failureText(session.status, "session"));
   return token;
 }
@@ -477,7 +481,14 @@ export async function fetchBondTape(input: string, options: BondTapeOptions = {}
   let answer = first;
   let issuer: BondIssuer | null = null;
   if (first.bonds.length === 0 && query?.kind === "issuer" && query.ticker && options.companyName) {
-    const company = await options.companyName(query.ticker).catch(() => null);
+    const company = await options.companyName(query.ticker).catch((error: unknown) => {
+      options.signal?.throwIfAborted();
+      if (error instanceof Error && error.name === "AbortError") throw error;
+      logFailure("trace-bonds.client", "Resolve bond issuer company failed")(error);
+      answer = { ...first, failures: [...first.failures, "Issuer-name lookup failed."] };
+      return null;
+    });
+    options.signal?.throwIfAborted();
     const name = company ? tapeIssuerName(company) : null;
     if (company && name && name !== query.name) {
       issuer = { company, name };
@@ -492,7 +503,7 @@ export async function fetchBondTape(input: string, options: BondTapeOptions = {}
   // No prints for the query: date the answer by the market's newest sale.
   const market = await postBondPage(token, [TRADED], 1, deadline)
     .then((payload) => latestTradeDate(mergeBondAnswers([{ payload, accepts: anyBond, limit: 1 }]).bonds))
-    .catch(() => null);
+    .catch(logFailure("trace-bonds.client", "Load bond market date failed", null));
   return { ...result, tradeDate: market };
 }
 

package/src/plugins/builtin/trace-bonds/headless.ts

@@ -89,7 +89,7 @@ export const traceBondsHeadless: HeadlessPaneDefinition<"bundle"> = {
         rows: bonds.map(reportRow),
         ...(query ? { empty: noPrintsText(query, tradeDate, issuer) } : {}),
       }],
-      complete: true,
+      complete: failures.length === 0,
       ...(failures.length > 0 ? { errors: failures } : {}),
       ...(truncated ? { notes: [TRUNCATED_TEXT] } : {}),
       ...(shown ? { warnings: [issuerFallbackText(query!, issuer)] } : {}),

package/src/plugins/builtin/vol-surface/pane.tsx

@@ -1,5 +1,5 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-import { DataTableView, EmptyState, PaneStatusBody, QueryBar, StatGrid, statGridRows, usePaneFooter, usePaneMenuItems,
+import { splitDelayedStatus, DataTableView, EmptyState, PaneStatusBody, QueryBar, StatGrid, statGridRows, usePaneFooter, usePaneMenuItems,
   usePaneNoticeFooter, usePaneTabs, usePaneTicker, type DataTableColumn, type DataTableKeyEvent, type StatItem } from "../../../components";
 import { useTableLoadMore } from "../../../components/table-view-shared";
 import { useStaticChartBitmapSize } from "../../../components/chart/composite/bitmap";
@@ -360,7 +360,7 @@ export function VolSurfacePane({ focused, width, height }: PaneProps) {
     info: [
       ...(active.loading ? [{ id: "loading", parts: [{ text: snapshot && snapshot.loaded < snapshot.requested
         ? `loading ${snapshot.loaded}/${snapshot.requested} expiries` : "loading", tone: "muted" as const }] }] : []),
-      ...(freshness ? [{ id: "source", parts: [{ text: freshness, tone: "muted" as const }] }] : []),
+      ...(freshness ? splitDelayedStatus({ id: "source", parts: [{ text: freshness, tone: "muted" }] }) : []),
       ...(snapshot?.expiries.some((entry) => entry.stale) ? [{ id: "stale", parts: [{ text: "stale", tone: "warning" as const }] }] : []),
       ...(selectedExpiry?.fit && activeTab === "smile" ? [{ id: "fit", parts: [{ text: `${selectedExpiry.fit.method} · RMSE ${(selectedExpiry.fit.residual * 100).toFixed(3)} vol pts`, tone: "muted" as const }] }] : []),
       ...(selectionStatus ? [{ id: "selection", parts: [{ text: selectionStatus, tone: "muted" as const }] }] : []),

package/src/plugins/builtin-editorial.ts

@@ -31,7 +31,7 @@ export const BUILTIN_EDITORIAL: Readonly<Record<string, BuiltinEditorial>> = {
     tagline: "Account, chat, Ask Gloom and Cloud data.",
     icon: "plugin-icons/gloomberb-cloud.webp",
   },
-  alerts: { categories: ["alerts"], tagline: "Price, market and filing alerts." },
+  alerts: { categories: ["alerts"], tagline: "Price, earnings, filing, news and flow alerts." },
   "alt-data": {
     categories: ["research", "data"],
     tagline: "Supply chains, hiring, apps, GPUs and power.",

package/src/plugins/compat.ts

@@ -68,6 +68,8 @@ export interface PluginManifest {
   id: string | null;
   /** The oldest Gloomberb the checkout says it runs on. */
   minGloomberb: string | null;
+  /** gloom.json `icon`: the plugin's logo, a path inside the checkout such as `icon.webp`. */
+  icon: string | null;
 }
 
 function readJson(path: string): Record<string, unknown> | null {
@@ -106,6 +108,7 @@ export function readPluginManifest(pluginDir: string): PluginManifest {
     minGloomberb: versionField(gloom?.minGloom)
       ?? versionField(gloom?.minGloomberb)
       ?? peerRangeMinimum(peers?.gloomberb),
+    icon: typeof gloom?.icon === "string" && gloom.icon.trim() ? gloom.icon.trim() : null,
   };
 }
 

package/src/plugins/external-runtime.ts

@@ -24,6 +24,11 @@ export function listExternalPlugins(): readonly LoadedExternalPlugin[] {
   return entries;
 }
 
+/** The logo of a plugin loaded here, as a `data:` URL; null for a built-in or a plugin without one. */
+export function externalPluginIcon(pluginId: string): string | null {
+  return entries.find((entry) => entry.plugin.id === pluginId)?.icon ?? null;
+}
+
 /** Replaces the entry for the same plugin id or directory, or appends. */
 export function upsertExternalPlugin(entry: LoadedExternalPlugin): void {
   const index = entries.findIndex((existing) => (

package/src/plugins/loader.ts

@@ -33,6 +33,12 @@ export interface LoadedExternalPlugin {
   repo?: string;
   /** A symlink to a local checkout (`gloomberb plugin link`) rather than a clone. */
   linked?: boolean;
+  /**
+   * The plugin's logo as a `data:` URL (plugin-icon.ts), for the desktop and
+   * the web to draw beside what it contributes, such as its broker. The
+   * terminal draws no images and leaves it unread.
+   */
+  icon?: string;
   error?: string;
   /**
    * The Gloomberb the checkout declares it needs, when this one is older. The

package/src/plugins/plugin-icon.ts

@@ -0,0 +1,61 @@
+import { existsSync, readFileSync, realpathSync, statSync } from "fs";
+import { basename, extname, isAbsolute, relative, resolve, sep } from "path";
+import { logFailure } from "../utils/log-failure";
+import { readPluginManifest } from "./compat";
+
+/**
+ * A plugin's logo as the desktop and the web draw it: the file its gloom.json
+ * names as `icon` (PLUGINS.md), or the `icon.svg`, `icon.webp` or `icon.png`
+ * a checkout without one ships beside its entry, read into a `data:` URL. The
+ * view has no filesystem, so the Bun process that reads the plugins folder
+ * hands the image over with the plugin's bundle.
+ */
+
+const ICON_TYPES: Readonly<Record<string, string>> = {
+  ".svg": "image/svg+xml",
+  ".webp": "image/webp",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+};
+
+const CONVENTIONAL_ICONS = ["icon.svg", "icon.webp", "icon.png"];
+
+/** A logo is drawn at most a few dozen pixels wide; anything larger is not one. */
+const MAX_ICON_BYTES = 256 * 1024;
+
+/**
+ * The icon `name` names inside `pluginDir`, typed by the name the plugin gave
+ * it, or null for a path that leaves the checkout or is not a small image.
+ */
+function iconFile(pluginDir: string, name: string): { path: string; type: string } | null {
+  const type = ICON_TYPES[extname(name).toLowerCase()];
+  if (!type) return null;
+  const root = realpathSync(pluginDir);
+  const path = resolve(root, name);
+  if (!existsSync(path)) return null;
+  // A link that points out of the checkout is not the plugin's to show.
+  const real = realpathSync(path);
+  const inside = relative(root, real);
+  if (!inside || inside === ".." || inside.startsWith(`..${sep}`) || isAbsolute(inside)) return null;
+  const info = statSync(real);
+  return info.isFile() && info.size > 0 && info.size <= MAX_ICON_BYTES ? { path: real, type } : null;
+}
+
+/**
+ * The plugin's logo as a `data:` URL. A declared icon that is missing,
+ * unusable or unreadable falls back to the conventional names, each tried on
+ * its own, so one file the process may not read does not hide the next.
+ */
+export function readPluginIcon(pluginDir: string): string | null {
+  const declared = readPluginManifest(pluginDir).icon;
+  for (const name of declared ? [declared, ...CONVENTIONAL_ICONS] : CONVENTIONAL_ICONS) {
+    try {
+      const icon = iconFile(pluginDir, name);
+      if (icon) return `data:${icon.type};base64,${readFileSync(icon.path).toString("base64")}`;
+    } catch (error) {
+      logFailure("plugin-icon", `Reading ${name} for ${basename(pluginDir)} failed`)(error);
+    }
+  }
+  return null;
+}

package/src/plugins/registry/host-actions.ts

@@ -9,6 +9,7 @@ import type { NewsQuery, NewsQueryState } from "../../types/news-source";
 import type {
   AppNotificationDelivery,
   AppNotificationRequest,
+  BrokerInstanceCreateOptions,
   BrokerInstanceUpdateOptions,
   PaneSettingField,
   PaneTemplateCreateOptions,
@@ -27,7 +28,7 @@ export interface PluginHostActions {
   getTicker(symbol: string): TickerRecord | null;
   getData(symbol: string): TickerFinancials | null;
   getConfig(): AppConfig;
-  createBrokerInstance(brokerType: string, label: string, values: Record<string, unknown>): Promise<BrokerInstanceConfig>;
+  createBrokerInstance(brokerType: string, label: string, values: Record<string, unknown>, options?: BrokerInstanceCreateOptions): Promise<BrokerInstanceConfig>;
   connectBrokerInstance(instanceId: string): Promise<void>;
   updateBrokerInstance(instanceId: string, values: Record<string, unknown>, options?: BrokerInstanceUpdateOptions): Promise<void>;
   syncBrokerInstance(instanceId: string): Promise<void>;

package/src/plugins/registry/index.ts

@@ -45,6 +45,7 @@ import type {
 import { debugLog } from "../../utils/debug-log";
 import { logFailure } from "../../utils/log-failure";
 import { EventBus, type HostEvents } from "../event-bus";
+import { externalPluginIcon } from "../external-runtime";
 import { isReservedBuiltinPluginId } from "../ownership";
 import { createPluginPersistence } from "../plugin-persistence";
 import { createPluginTeamState } from "../team-state";
@@ -532,6 +533,12 @@ export class PluginRegistry implements PluginRuntimeAccess {
     return this.contributions.brokersMap.owners.get(brokerType);
   }
 
+  /** The logo of the plugin that registered `brokerType` (its gloom.json `icon`), for lists of brokers. */
+  getBrokerLogo = (brokerType: string): string | null => {
+    const owner = this.getBrokerPluginId(brokerType);
+    return owner ? externalPluginIcon(owner) : null;
+  };
+
   getShortcutPluginId(shortcutId: string): string | undefined {
     return this.contributions.shortcutsMap.owners.get(shortcutId);
   }
@@ -619,6 +626,7 @@ export class PluginRegistry implements PluginRuntimeAccess {
       getData: (ticker) => this.getData(ticker),
       getTicker: (symbol) => this.getTicker(symbol),
       getConfig: () => this.getConfig(),
+      getBrokerAdapter: this.getBrokerAdapter,
       getPaneDef: (paneId) => contributions.panesMap.get(paneId),
       marketData: this.marketData,
       connectionHealth: this.connectionHealth,
@@ -630,7 +638,7 @@ export class PluginRegistry implements PluginRuntimeAccess {
         updateLayout: (layout) => this.updateLayout(layout),
         resolvePaneTarget: (paneId) => this.resolvePaneTarget(paneId),
       }),
-      createBrokerInstance: (brokerType, label, values) => this.createBrokerInstance(brokerType, label, values),
+      createBrokerInstance: (brokerType, label, values, options) => this.createBrokerInstance(brokerType, label, values, options),
       updateBrokerInstance: this.updateBrokerInstance,
       syncBrokerInstance: this.syncBrokerInstance,
       removeBrokerInstance: this.removeBrokerInstance,

package/src/plugins/runtime/context.tsx

@@ -18,6 +18,11 @@ export interface PluginRuntimeAccess extends CapabilityInvoker, PluginRuntimeHos
   getBrokerAdapter(brokerType: string): BrokerAdapter | null;
   /** Every broker adapter installed now, read when called: plugins come and go. */
   listBrokerAdapters(): BrokerAdapter[];
+  /**
+   * The logo of the plugin that registered a broker adapter, as an image URL
+   * for the desktop and the web; null when it has none.
+   */
+  getBrokerLogo?(brokerType: string): string | null;
   subscribeResumeState(pluginId: string, key: string, listener: () => void): () => void;
   getResumeState<T = unknown>(pluginId: string, key: string, schemaVersion?: number): T | null;
   setResumeState(pluginId: string, key: string, value: unknown, schemaVersion?: number): void;

package/src/plugins/runtime/index.tsx

@@ -78,11 +78,14 @@ export function useCapabilityInvoker(): CapabilityInvoker {
   return usePluginRenderContext().runtime;
 }
 
+const noBrokerLogo = (): string | null => null;
+
 export function usePluginBrokerActions() {
   const { runtime } = usePluginRenderContext();
   return {
     getBrokerAdapter: runtime.getBrokerAdapter,
     listBrokerAdapters: runtime.listBrokerAdapters,
+    getBrokerLogo: runtime.getBrokerLogo ?? noBrokerLogo,
     createBrokerInstance: runtime.createBrokerInstance,
     connectBrokerInstance: runtime.connectBrokerInstance,
     updateBrokerInstance: runtime.updateBrokerInstance,

package/src/portfolio/column-values.ts

@@ -8,6 +8,7 @@ import type { EarningsEvent } from "../types/data-provider";
 import type { TickerRecord } from "../types/ticker";
 import { colors, priceColor } from "../theme/colors";
 import { formatQuoteAgeWithSource, resolveQuoteAgeTimestamp } from "../market-data/quotes/time";
+import { delistingStateLabel } from "../market-data/quotes/delisting";
 import { formatFeedTime, formatShortDate, parseDisplayDate, type ShortDateOptions } from "../utils/datetime-format";
 import { convertCurrency, formatCompact, formatCompactAmount, formatNumber, formatPercentRaw } from "../utils/format";
 import {
@@ -40,6 +41,7 @@ import { currentListingName } from "../tickers/listing-name";
 import { PRICE_SPARKLINE_COLUMN_ID } from "../components/price-sparkline/view";
 import { followLiveSparklinePrice, resolveSparklineHistory, sparklineValues } from "../components/price-sparkline/model";
 import {
+  analystTargetDisplayCurrency,
   listingDividendYield,
   liveDividendYield,
   liveFiftyTwoWeekRange,
@@ -67,6 +69,7 @@ import {
 } from "./valuation-basis";
 import { futuresQuantityText, futuresSettlementDisplay, type PortfolioFuturesTerms } from "./futures-positions";
 import { isFiniteNumber } from "../utils/guards";
+import { currencyCodeLabel } from "../utils/currency-units";
 import {
   allocationFigures,
   formatAllocationDrift,
@@ -453,7 +456,7 @@ export function getColumnValue(
         ),
       };
     case "currency":
-      return { text: compactText(listedCurrency(positionCurrency, quoteCurrency, ticker, quote)) };
+      return { text: compactText(currencyCodeLabel(listedCurrency(positionCurrency, quoteCurrency, ticker, quote))) };
     case "sector":
       return { text: compactText(ticker.metadata.sector || financials?.profile?.sector) };
     case "industry":
@@ -464,6 +467,8 @@ export function getColumnValue(
       return resolvePortfolioPriceValue(headlineQuote, brokerMarkPrice, headlineQuote ? currentQuoteOptions : markOptions, col.width, quote?.marketState);
     case "change":
       if (!headlineQuote) return { text: "—" };
+      // A listing that no longer trades has no day's move: its last session's is years old.
+      if (quote?.delisting) return { text: delistingStateLabel(quote.delisting), color: colors.warning };
       return {
         text: formatSignedMarketPrice(headlineQuote.change, { ...currentQuoteOptions, maxWidth: col.width }),
         color: marketChangeColor(headlineQuote.change, quote?.marketState),
@@ -489,6 +494,7 @@ export function getColumnValue(
       return { text: `${formatCompact(quote?.bidSize)}/${formatCompact(quote?.askSize)}` };
     }
     case "change_pct": {
+      if (quote?.delisting) return { text: delistingStateLabel(quote.delisting), color: colors.warning };
       const changePercent = headlineChangePercent(headlineQuote, quote);
       return quote
         ? { text: formatPercentRaw(changePercent), color: marketChangeColor(changePercent, quote.marketState) }
@@ -573,6 +579,7 @@ export function getColumnValue(
       return { text, color: /[1-9]/.test(text) ? priceColor(allocation.tradeValue!) : undefined };
     }
     case "day_pnl":
+      if (quote?.delisting) return { text: delistingStateLabel(quote.delisting), color: colors.warning };
       if (activeQuote && isFiniteNumber(activeQuote.change) && Number.isFinite(positionMetrics.grossPriceUnits) && positionMetrics.grossPriceUnits !== 0) {
         const dayPnl = toBaseQuote(totalPriceUnits * activeQuote.change);
         return { text: formatCompactAmount(dayPnl, { signed: true }), color: priceColor(dayPnl) };
@@ -603,7 +610,8 @@ export function getColumnValue(
       const analyst = mapData(ctx.analystResearch, ticker.metadata.ticker);
       if (analyst.pending) return { text: "…" };
       const value = targetValue(analyst.data);
-      const currency = analyst.data?.priceTarget?.currency ?? analyst.data?.currency ?? quoteCurrency;
+      // The target's own currency: one in pounds under a quote in pence reads £, not p.
+      const currency = analystTargetDisplayCurrency(analyst.data, quoteCurrency, displayQuote?.price);
       return {
         text: value == null
           ? "—"
@@ -730,9 +738,9 @@ export function getSortValue(
         ? (quote?.bidSize ?? 0) + (quote?.askSize ?? 0)
         : null;
     case "change":
-      return headlineQuote?.change ?? null;
+      return quote?.delisting ? null : headlineQuote?.change ?? null;
     case "change_pct":
-      return headlineChangePercent(headlineQuote, quote) ?? null;
+      return quote?.delisting ? null : headlineChangePercent(headlineQuote, quote) ?? null;
     case "volume":
       return reportedQuoteVolume(quote);
     case "dollar_volume": {
@@ -774,6 +782,7 @@ export function getSortValue(
     case "trade_value":
       return rowAllocation(ticker, activeQuote, baseMetrics, toBaseQuote, ctx).tradeValue;
     case "day_pnl":
+      if (quote?.delisting) return null;
       if (activeQuote && isFiniteNumber(activeQuote.change) && Number.isFinite(positionMetrics.grossPriceUnits) && positionMetrics.grossPriceUnits !== 0) {
         return toBaseQuote(totalPriceUnits * activeQuote.change);
       }