gloomberb 0.16.2 → 0.16.4

package/src/renderers/electrobun/shared/protocol.ts

@@ -3,6 +3,7 @@ import type { PaneRuntimeState } from "../../../core/state/app/state";
 import type { DesktopDockPreviewState, DesktopSharedStateSnapshot, DesktopThemePreviewState } from "../../../types/desktop-window";
 import type { DesktopApplicationMenuCommand } from "../../../types/desktop-menu";
 import type { AppConfig } from "../../../types/config";
+import type { CachedResourceRecord, ResourceCacheKey } from "../../../data/resource-store";
 import type { TickerRecord } from "../../../types/ticker";
 import type { ReleaseInfo, UpdateCheckResult, UpdateProgress } from "../../../updater";
 import type { CapabilityManifest } from "../../../capabilities";
@@ -18,8 +19,12 @@ export interface ElectrobunBackendInit {
   desktopSnapshot: DesktopSharedStateSnapshot | null;
   desktopThemePreview: DesktopThemePreviewState;
   pluginState: Record<string, Record<string, unknown>>;
+  /** Saved broker account snapshots, which the view's in-memory store starts from. */
+  savedResources?: CachedResourceRecord[];
   capabilityManifests: CapabilityManifest[];
   desktopPlatform: string;
+  /** The machine name, which a remote assistant sees this desktop app under. */
+  hostName?: string;
   windowKind: "main" | "detached";
   paneId?: string;
   /** What the view needs to send crash reports and usage counts the same way the Bun process would. */
@@ -226,6 +231,9 @@ interface DesktopBackendRequestMap {
     response: null;
   };
   "session.delete": { request: { sessionId: string }; response: null };
+  /** Saves or drops a broker account snapshot in the cache database; nothing else is accepted. */
+  "resources.set": { request: { record: CachedResourceRecord }; response: null };
+  "resources.delete": { request: { key: ResourceCacheKey }; response: null };
 }
 
 export type DesktopBackendRequestMethod = keyof DesktopBackendRequestMap;
@@ -251,7 +259,10 @@ export type DesktopWorkspaceRequest = DesktopBackendRequestFor<Extract<DesktopBa
 export type DesktopPluginStateRequest = DesktopBackendRequestFor<Extract<DesktopBackendRequestMethod, `pluginState.${string}`>>;
 export type DesktopHostRequest = DesktopBackendRequestFor<Extract<DesktopBackendRequestMethod, `host.${string}`>>;
 export type DesktopCoreRequest = DesktopBackendRequestFor<
-  Extract<DesktopBackendRequestMethod, `update.${string}` | `ticker.${string}` | `config.${string}` | `session.${string}`>
+  Extract<
+    DesktopBackendRequestMethod,
+    `update.${string}` | `ticker.${string}` | `config.${string}` | `session.${string}` | `resources.${string}`
+  >
 >;
 
 interface BackendRequestPayload {

package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx

@@ -397,6 +397,9 @@ function HydratePayload({
       tickers: new Map(payload.tickers.map((ticker) => [ticker.metadata.ticker, ticker])),
     });
     dispatch({ type: "HYDRATE_FINANCIALS", financials: new Map(payload.financials) });
+    for (const [instanceId, accounts] of Object.entries(payload.brokerAccounts ?? {})) {
+      dispatch({ type: "SET_BROKER_ACCOUNTS", instanceId, accounts });
+    }
     dispatch({ type: "SET_INITIALIZED" });
 
     return waitForShotReadiness();
@@ -438,7 +441,7 @@ function ShotPane({ payload, registry }: { payload: DesktopPaneShotPayload; regi
   const height = payload.heightCells;
   // PORT keeps what its basket covers, so a capture never reads as the whole account.
   return (
-    <PaneShotFrame paneId={instance.instanceId} title={title} width={width} height={height} preserveStatus={["time-sales", "gpu", "hiring", "apps", "catalysts", "litigation", "perps", "members", "analytics"].includes(pane.id)}>
+    <PaneShotFrame paneId={instance.instanceId} title={title} width={width} height={height} statusLine={payload.statusLine === true} preserveStatus={["time-sales", "gpu", "hiring", "apps", "catalysts", "litigation", "perps", "members", "analytics"].includes(pane.id)}>
       {(bodyFrame) => <PaneContent
         component={pane.component}
         paneId={instance.instanceId}

package/src/renderers/electrobun/view/cli-pane-shot-frame.tsx

@@ -1,20 +1,116 @@
 /** @jsxImportSource react */
-import type { ReactNode } from "react";
+import { useEffect, useState, type ReactNode } from "react";
 import { FloatingPaneWrapper } from "../../../components/layout/floating-pane";
-import { PaneFooterProvider, hasPaneFooterContent } from "../../../components/layout/pane/footer";
+import { PaneFooterProvider, hasPaneFooterContent, type PaneFooterSegment } from "../../../components/layout/pane/footer";
 import { resolvePaneBodyFrame } from "../../../components/layout/pane/sizing";
 
-/** Static captures retain warnings and optional source status without action shortcuts. */
-export function PaneShotFrame({ paneId, title, width, height, preserveStatus = false, children }: {
+declare global {
+  interface Window {
+    /**
+     * Set by a capture that carries a status line: shows the first of the
+     * variants (longest first) that fits the footer, cut in the middle when
+     * none does, and resolves to the text shown.
+     */
+    __GLOOM_CLI_SHOT_FIT_STATUS__?: (variants: string[]) => Promise<string>;
+  }
+}
+
+/**
+ * Holds the footer row from the first frame, while the status line is still
+ * being worked out from what the pane loaded, so the body never resizes.
+ */
+const PENDING_STATUS = "\u00a0";
+
+function nextFrames(count: number): Promise<void> {
+  return new Promise((resolve) => {
+    const step = (left: number) => (left <= 0 ? resolve() : requestAnimationFrame(() => step(left - 1)));
+    step(count);
+  });
+}
+
+/** Keeps the start and the end of a line that does not fit, `keep` characters in all. */
+function middleEllipsis(text: string, keep: number): string {
+  if (keep >= text.length) return text;
+  const head = Math.ceil(keep / 2);
+  const tail = Math.max(0, keep - head);
+  return `${text.slice(0, head).trimEnd()}…${tail > 0 ? text.slice(text.length - tail).trimStart() : ""}`;
+}
+
+/**
+ * The first variant that fits, else the last one cut in the middle as little
+ * as it must be. `show` puts a text on screen and resolves once it is drawn.
+ */
+async function fitStatusLine(
+  variants: readonly string[],
+  show: (text: string) => Promise<void>,
+  overflows: () => boolean,
+): Promise<string> {
+  for (const variant of variants) {
+    await show(variant);
+    if (!overflows()) return variant;
+  }
+  const last = variants.at(-1) ?? "";
+  let low = 1;
+  let high = last.length - 1;
+  let best = middleEllipsis(last, 1);
+  while (low <= high) {
+    const keep = Math.floor((low + high) / 2);
+    const text = middleEllipsis(last, keep);
+    await show(text);
+    if (overflows()) {
+      high = keep - 1;
+    } else {
+      best = text;
+      low = keep + 1;
+    }
+  }
+  await show(best);
+  return best;
+}
+
+function footerOverflows(): boolean {
+  const footer = document.querySelector('[data-gloom-role="pane-footer"]');
+  if (!footer) return false;
+  return [footer, ...footer.querySelectorAll("*")].some((element) => (
+    element instanceof HTMLElement && element.scrollWidth > element.clientWidth + 1
+  ));
+}
+
+function useShotStatusLine(enabled: boolean): string {
+  const [text, setText] = useState(PENDING_STATUS);
+  useEffect(() => {
+    if (!enabled) return;
+    window.__GLOOM_CLI_SHOT_FIT_STATUS__ = (variants) => fitStatusLine(variants, async (next) => {
+      setText(next);
+      await nextFrames(2);
+    }, footerOverflows);
+    return () => {
+      delete window.__GLOOM_CLI_SHOT_FIT_STATUS__;
+    };
+  }, [enabled]);
+  return text;
+}
+
+/**
+ * Static captures retain warnings and optional source status without action
+ * shortcuts. With `statusLine` the footer also carries the capture's dated
+ * status line (`Fri 9 Oct close · 15 min delayed · markets closed until Mon`),
+ * inside the requested size: the body gives up the footer row for it.
+ */
+export function PaneShotFrame({ paneId, title, width, height, preserveStatus = false, statusLine = false, children }: {
   paneId: string;
   title: string;
   width: number;
   height: number;
   preserveStatus?: boolean;
+  statusLine?: boolean;
   children: (frame: ReturnType<typeof resolvePaneBodyFrame>) => ReactNode;
 }) {
+  const statusText = useShotStatusLine(statusLine);
   return <PaneFooterProvider>{(registeredFooter) => {
-    const footer = { info: registeredFooter.info.filter((segment) => preserveStatus || segment.icon === "warning"), hints: [], menu: [], keys: [] };
+    const status: PaneFooterSegment[] = statusLine ? [{ id: "shot-status", parts: [{ text: statusText, tone: "label" }] }] : [];
+    const info = registeredFooter.info.filter((segment) => preserveStatus || segment.icon === "warning");
+    const footer = { info: [...info, ...status], hints: [], menu: [], keys: [] };
     const bodyFrame = resolvePaneBodyFrame({
       width,
       height,

package/src/renderers/electrobun/view/host/native.ts

@@ -14,16 +14,6 @@ const contextMenuActionScope = new DesktopContextMenuActionScope(
   CONTEXT_MENU_ACTION_TTL_MS,
 );
 
-export function startElectrobunWindowDrag(): void {
-  window.__electrobunInternalBridge?.postMessage(JSON.stringify([
-    JSON.stringify({
-      type: "message",
-      id: "startWindowMove",
-      payload: { id: window.__electrobunWindowId },
-    }),
-  ]));
-}
-
 export async function showDesktopContextMenu(items: ContextMenuItem[]): Promise<boolean> {
   if (!NATIVE_CONTEXT_MENU_SUPPORTED) return false;
   contextMenuActionScope.clear();

package/src/renderers/electrobun/view/host/window-move.ts

@@ -0,0 +1,28 @@
+function postWindowMove(id: "startWindowMove" | "stopWindowMove"): void {
+  window.__electrobunInternalBridge?.postMessage(JSON.stringify([
+    JSON.stringify({ type: "message", id, payload: { id: window.__electrobunWindowId } }),
+  ]));
+}
+
+let endWindowMove: (() => void) | null = null;
+
+/**
+ * Moves the window with the pointer until the button comes up. Electrobun
+ * stops the move when its native monitor sees the release, but only if the
+ * start reached it first: the start goes through the Bun process, and a quick
+ * click releases before it lands, leaving the window following the bare
+ * pointer until the next click. The release is sent from here too, as
+ * Electrobun's own drag regions do; it always arrives after the start.
+ */
+export function startElectrobunWindowDrag(): void {
+  // A press whose release never reached the page (it ended outside the window) is over.
+  endWindowMove?.();
+  postWindowMove("startWindowMove");
+  const end = () => {
+    window.removeEventListener("mouseup", end, true);
+    if (endWindowMove === end) endWindowMove = null;
+    postWindowMove("stopWindowMove");
+  };
+  endWindowMove = end;
+  window.addEventListener("mouseup", end, true);
+}

package/src/renderers/electrobun/view/main.tsx

@@ -210,7 +210,10 @@ async function boot() {
   });
 
   const remoteControlAdapter = init.windowKind === "main"
-    ? { registerHandler: setElectrobunRemoteRequestHandler }
+    ? {
+      registerHandler: setElectrobunRemoteRequestHandler,
+      terminalDevice: { kind: "desktop" as const, name: init.hostName?.trim() || "Gloom desktop" },
+    }
     : undefined;
   measurePerfAsync("startup.electrobun.root-render", async () => {
     root.render(

package/src/renderers/electrobun/view/remote/persistence.ts

@@ -4,7 +4,8 @@ import {
   SESSION_SAVE_DEBOUNCE_MS,
 } from "../../../../state/persist-scheduler";
 import { backendRequest, getElectrobunBackendInitSnapshot } from "../backend-rpc";
-import { MemoryResourceStore } from "../../../../data/memory-resource-store";
+import { WriteThroughResourceStore } from "../../../../data/memory-resource-store";
+import { isBrokerAccountSnapshotKey } from "../../../../brokers/account-cache";
 
 class RemoteSessionStore {
   private snapshot = getElectrobunBackendInitSnapshot()?.sessionSnapshot ?? null;
@@ -123,9 +124,21 @@ class RemotePluginStateStore {
   }
 }
 
+/**
+ * Caches stay in the view's memory, except broker account snapshots: the Bun
+ * process saves those in the cache database, as the terminal does, so a
+ * broker portfolio opens with its last known equity and cash.
+ */
+function createViewResourceStore(): WriteThroughResourceStore {
+  return new WriteThroughResourceStore(getElectrobunBackendInitSnapshot()?.savedResources ?? [], {
+    set: (record) => void backendRequest("resources.set", { record }).catch(() => {}),
+    delete: (key) => void backendRequest("resources.delete", { key }).catch(() => {}),
+  }, isBrokerAccountSnapshotKey);
+}
+
 export class RemotePersistence {
   readonly tickers = {};
-  readonly resources = new MemoryResourceStore();
+  readonly resources = createViewResourceStore();
   readonly pluginState = new RemotePluginStateStore(getElectrobunBackendInitSnapshot()?.pluginState ?? {});
   readonly sessions = new RemoteSessionStore();
 

package/src/renderers/electrobun/view/ui-host.tsx

@@ -2,11 +2,8 @@
 import type { RendererHost, UiHost } from "../../../ui/host";
 import { flushUsageCounts } from "../../../telemetry/usage-counts";
 import { backendRequest } from "./backend-rpc";
-import {
-  NATIVE_CONTEXT_MENU_SUPPORTED,
-  showDesktopContextMenu,
-  startElectrobunWindowDrag,
-} from "./host/native";
+import { NATIVE_CONTEXT_MENU_SUPPORTED, showDesktopContextMenu } from "./host/native";
+import { startElectrobunWindowDrag } from "./host/window-move";
 import { createDomUiHost } from "../../dom/dom-ui-host";
 
 export function createWebUiHost(desktopPlatform?: string): UiHost {

package/src/renderers/opentui/input-host.tsx

@@ -1,8 +1,10 @@
+import { flushSync } from "@opentui/react";
 import { useMemo, type ReactNode } from "react";
 import { useNativeRenderer } from "../../ui";
 import {
   createShortcutRegistry,
   InputHostProvider,
+  useRegisteredBeforeShortcut,
   useRegisteredShortcut,
   type InputHost,
 } from "../../react/input";
@@ -10,7 +12,7 @@ import { toKeyEventLike, useKeyboard, useTerminalDimensions } from "./host";
 
 export function OpenTuiInputHostProvider({ children }: { children: ReactNode }) {
   const renderer = useNativeRenderer();
-  const shortcutRegistry = useMemo(() => createShortcutRegistry(), []);
+  const shortcutRegistry = useMemo(() => createShortcutRegistry({ flushSync }), []);
 
   useKeyboard((event) => {
     const shortcutEvent = toKeyEventLike(event);
@@ -22,6 +24,9 @@ export function OpenTuiInputHostProvider({ children }: { children: ReactNode })
     useShortcut(handler, options) {
       useRegisteredShortcut(shortcutRegistry, handler, options);
     },
+    useBeforeShortcut(listener) {
+      useRegisteredBeforeShortcut(shortcutRegistry, listener);
+    },
     useViewport() {
       const dimensions = useTerminalDimensions();
       return { width: dimensions.width, height: dimensions.height };

package/src/renderers/opentui/start.tsx

@@ -1,3 +1,4 @@
+import { hostname } from "os";
 import { getGloomberbDirs } from "../../data/config/home";
 import { existsSync, mkdirSync } from "fs";
 import { App } from "../../app";
@@ -38,6 +39,8 @@ import {
 import { currentTelemetryConfig } from "../../telemetry/live-config";
 import { flushUsageCounts, installUsageCounter, usageCountsEnabled } from "../../telemetry/usage-counts";
 import { attentionCountsEnabled, installAttentionCounter } from "../../telemetry/attention-counts";
+import { starPromptEnvironmentAllows } from "../../app/star-prompt/model";
+import { allowStarPrompt } from "../../app/star-prompt/runtime";
 
 // Declared here rather than sniffed: the desktop view and the hosted browser
 // app are both browser contexts but differ in what plugins may do.
@@ -56,6 +59,7 @@ export async function startOpenTuiApp({ externalPlugins, cliLaunchRequest }: Sta
   const appLog = debugLog.createLogger("app");
   appLog.info("Gloomberb starting");
   const remoteControlAdapter: RemoteControlAdapter = {
+    terminalDevice: { kind: "tui", name: hostname() },
     startServer: ({ dataDir, handle }) => {
       let closed = false;
       const serverPromise: Promise<RemoteControlServer> = startRemoteControlServer({
@@ -121,6 +125,11 @@ export async function startOpenTuiApp({ externalPlugins, cliLaunchRequest }: Sta
       officialPluginIds: loadOfficialPluginIds,
     });
     const stopAttention = installAttentionCounter(() => attentionCountsEnabled(currentTelemetryConfig(config), process.env));
+    allowStarPrompt(starPromptEnvironmentAllows({
+      env: process.env,
+      stdinIsTTY: process.stdin.isTTY,
+      stdoutIsTTY: process.stdout.isTTY,
+    }));
     host = await measurePerfAsync("startup.opentui.create-host", () => createOpenTuiHost());
     const renderer = host.renderer;
     renderer.once("destroy", stopAttention);

package/src/renderers/opentui/ui-host.tsx

@@ -2,6 +2,7 @@ import { RGBA, StyledText as OpenTuiStyledText, SyntaxStyle, TextAttributes as O
 import { createElement, forwardRef, useEffect, useRef, useState, type ReactNode } from "react";
 import { TextAttributes, type UiHost, type TextProps } from "../../ui/host";
 import { renderAsciiText } from "../../ui/ascii-font";
+import { scrollBoxScrollsVertically } from "../../ui/scroll-box-axis";
 import { OpenTuiImageSurface } from "./image/surface";
 import { OpenTuiChartSurface } from "./chart-surface";
 
@@ -141,7 +142,12 @@ function mapTextContent(content: unknown): unknown {
 }
 
 const OpenTuiBox = createOpenTuiPrimitive("box");
-const OpenTuiScrollBox = createOpenTuiPrimitive("scrollbox");
+const OpenTuiScrollBoxPrimitive = createOpenTuiPrimitive("scrollbox");
+// The native box scrolls vertically unless scrollY is false; the shared rule
+// also keeps the one-row horizontal strips from scrolling on that axis.
+const OpenTuiScrollBox = forwardRef<unknown, OpenTuiPrimitiveProps>(function OpenTuiScrollBox(props, ref) {
+  return createElement(OpenTuiScrollBoxPrimitive, { ...props, scrollY: scrollBoxScrollsVertically(props), ref });
+});
 const OpenTuiInput = createOpenTuiPrimitive("input");
 const OpenTuiTextarea = createOpenTuiPrimitive("textarea");
 const OpenTuiMediaSurface = createOpenTuiPrimitive("box");

package/src/shares/portable-layout.ts

@@ -1,4 +1,5 @@
 import type { PaneRuntimeState } from "../core/state/app/types";
+import { foldPaneLayout } from "../data/config/store/fold-panes";
 import { publicTickerBindingSymbol } from "../tickers/selection";
 import { pinFollowingPane } from "../layout/pane-follow";
 import {
@@ -641,28 +642,37 @@ export function materializeMarketplaceLayout(
     `${paneId.slice(0, 80)}:shared-${crypto.randomUUID().replaceAll("-", "").slice(0, 20)}`
   ),
 ): { layout: LayoutConfig; paneState: Record<string, PaneRuntimeState> } {
-  const ids = new Map(payload.layout.instances.map((instance, index) => [
+  // A layout or pane shared before SIV and SOVR folded into SI and CDX still
+  // names the old panes. It opens the way a saved layout migrates.
+  const folded = foldPaneLayout(payload.layout);
+  const source = {
+    layout: folded.layout,
+    paneState: Object.fromEntries(Object.entries(payload.paneState).flatMap(([id, state]) => (
+      folded.removed.has(id) ? [] : [[folded.idMap.get(id) ?? id, state]]
+    ))),
+  };
+  const ids = new Map(source.layout.instances.map((instance, index) => [
     instance.instanceId,
     createId(instance.paneId, index),
   ]));
   if (new Set(ids.values()).size !== ids.size) throw new Error("Could not create unique pane ids for this layout.");
   const layout: LayoutConfig = {
-    dockRoot: mapDockNode(payload.layout.dockRoot, ids),
-    instances: payload.layout.instances.map((instance) => ({
+    dockRoot: mapDockNode(source.layout.dockRoot, ids),
+    instances: source.layout.instances.map((instance) => ({
       ...structuredClone(instance),
       instanceId: ids.get(instance.instanceId)!,
       ...(instance.binding ? { binding: mapBinding(instance.binding, ids) } : {}),
     })),
-    floating: payload.layout.floating.map((entry) => ({
+    floating: source.layout.floating.map((entry) => ({
       ...entry,
       instanceId: ids.get(entry.instanceId) ?? entry.instanceId,
     })),
-    detached: payload.layout.detached.map((entry) => ({
+    detached: source.layout.detached.map((entry) => ({
       ...entry,
       instanceId: ids.get(entry.instanceId) ?? entry.instanceId,
     })),
   };
-  const paneState = Object.fromEntries(Object.entries(payload.paneState).flatMap(([id, state]) => {
+  const paneState = Object.fromEntries(Object.entries(source.paneState).flatMap(([id, state]) => {
     const materializedId = ids.get(id);
     return materializedId ? [[materializedId, structuredClone(state)]] : [];
   }));

package/src/sources/gloomberb-cloud/index.ts

@@ -39,13 +39,13 @@ import { normalizeNewsFeed } from "../../news/news-model";
 import { resolveCurrencyUnit } from "../../utils/currency-units";
 import { canonicalExchange, canonicalTickerKey, parsePublicTickerKey } from "../../utils/exchanges";
 import { normalizePriceHistory, priceHistoryIntervalMs, reachesLatestSettledSession } from "../../utils/price-history";
-import { createProviderMiss } from "../provider-errors";
+import { createProviderMiss, providerMissReason } from "../provider-errors";
 import { assertSecRegistrantMatches } from "../sec-registrant";
 import { nonUsSecListingVenue } from "../../utils/sec";
 import { publicListingTarget } from "../listing-target";
 import { canonicalHistoryInterval, HistoryRetentionError, parseHistoryRecoveryCandidate, parseHistoryRetention, type HistoryRetention } from "../history-retention";
 import { getRouterEntityKey } from "../provider-router/cache";
-import { tickerHasListingSuffix } from "../listing-symbols";
+import { hongKongListingCode, tickerHasListingSuffix } from "../listing-symbols";
 import { parseSecAcceptanceTime } from "../sec-edgar/acceptance-time";
 import { hasMalformedIntradayHistory } from "../../time-series/history-quality";
 import {
@@ -57,6 +57,7 @@ import {
   formatCloudDateTime,
   isEmptyCloudStatus,
   mapBatchError,
+  NOT_FOUND_REASON,
   mapCloudFinancials,
   mapOptionsChain,
   mapPricePoint,
@@ -124,7 +125,7 @@ async function withCloudFallback<T>(load: () => Promise<T>, message: string): Pr
     return await load();
   } catch (error) {
     if (isCloudProviderMiss(error)) {
-      throw createProviderMiss(message);
+      throw createProviderMiss(message, providerMissReason(error));
     }
     throw error;
   }
@@ -237,7 +238,7 @@ function cloudHistoryResolution(interval: string): ManualChartResolution | null
 }
 
 function quoteTargetKey(symbol: string, exchange?: string): string {
-  const target = publicListingTarget(symbol, exchange);
+  const target = cloudInstrumentTarget(symbol, exchange);
   const base = target.exchange && tickerHasListingSuffix(target.symbol) ? target.symbol.slice(0, target.symbol.indexOf(".")) : target.symbol;
   return canonicalTickerKey(base, target.exchange);
 }
@@ -251,7 +252,14 @@ function cloudResponseTargetKey(key: string, requested: Set<string>): string | u
     ? symbol : undefined;
 }
 
-const cloudInstrumentTarget = publicListingTarget;
+/**
+ * The listing as Gloom Cloud knows it. A Hong Kong code goes out with its four
+ * digits: Cloud has no 700 or 5 on HKEX, only 0700 and 0005.
+ */
+function cloudInstrumentTarget(symbol: string, exchange?: string) {
+  const target = publicListingTarget(symbol, exchange);
+  return target.exchange ? { ...target, symbol: hongKongListingCode(target.symbol, target.exchange) } : target;
+}
 
 function cloudHistoryRecovery(
   context: MarketDataRequestContext | undefined,
@@ -323,7 +331,7 @@ function unwrapRequiredCloudResponse<T>(response: CloudMarketResponse<T>, messag
     return response.data;
   }
   if (isEmptyCloudStatus(response.status)) {
-    throw createProviderMiss(response.reasonCode ?? message);
+    throw createProviderMiss(response.reasonCode ?? message, response.message, { notFound: response.reasonCode === NOT_FOUND_REASON });
   }
   throw new Error(response.reasonCode ?? message);
 }
@@ -404,13 +412,14 @@ export class GloomberbCloudProvider implements AssetDataProvider {
     return withCloudFallback(
       async () => {
         const response = await apiClient.getCloudQuote(target.symbol, target.exchange);
-        if (isStaleCloudResponse(response)) {
-          throw createProviderMiss(`Cloud quotes are stale for ${ticker}`);
-        }
-        return retainRequestedQuoteSymbol(mapQuote(
+        const quote = retainRequestedQuoteSymbol(mapQuote(
           unwrapRequiredCloudResponse(response, `Cloud quotes are unavailable for ${ticker}`),
           response.providerMeta,
         ), ticker);
+        // A stale answer is the last price the service has. It stays flagged, so
+        // no freshness check passes it and only a request with no current quote
+        // from any source falls back to it.
+        return isStaleCloudResponse(response) ? { ...quote, stale: true } : quote;
       },
       `Cloud quotes are unavailable for ${ticker}`,
     );

package/src/sources/gloomberb-cloud/normalizers.ts

@@ -1,5 +1,6 @@
 import { futuresGenericListing, futuresGenericPriceBasis } from "../../utils/futures-generic";
 import type { TimeRange } from "../../time-series/range";
+import { RANGE_HISTORY_RESOLUTION } from "../../time-series/resolution";
 import type {
   FinancialStatement,
   Fundamentals,
@@ -305,6 +306,9 @@ export function mapOptionsChain(
   };
 }
 
+/** The reason code Gloom Cloud gives an empty answer for a symbol no listing carries. */
+export const NOT_FOUND_REASON = "NOT_FOUND";
+
 export function isEmptyCloudStatus(
   status: CloudMarketResponse<unknown>["status"],
 ): boolean {
@@ -316,7 +320,7 @@ export function mapBatchError<T>(
   fallbackMessage: string,
 ): Error {
   if (isEmptyCloudStatus(item.status)) {
-    return createProviderMiss(item.reasonCode ?? fallbackMessage);
+    return createProviderMiss(item.reasonCode ?? fallbackMessage, item.message, { notFound: item.reasonCode === NOT_FOUND_REASON });
   }
   return new Error(item.reasonCode ?? fallbackMessage);
 }
@@ -370,29 +374,24 @@ export function formatCloudDateTime(
   return `${year}-${month}-${day}`;
 }
 
+const HISTORY_OUTPUT_SIZE: Record<TimeRange, number> = {
+  "1D": 24 * 12,
+  "1W": 7 * 24,
+  "1M": 31,
+  "3M": 93,
+  "6M": 186,
+  "1Y": 366,
+  "5Y": 261,
+  "ALL": 600,
+};
+
+/** The bar size comes from the shared range table, which `gloomberb help history` also lists. */
 export function toHistoryRequest(range: TimeRange): {
   interval: string;
   outputsize: number;
   rangeKey: TimeRange;
 } {
-  switch (range) {
-    case "1D":
-      return { interval: "5min", outputsize: 24 * 12, rangeKey: range };
-    case "1W":
-      return { interval: "1h", outputsize: 7 * 24, rangeKey: range };
-    case "1M":
-      return { interval: "1day", outputsize: 31, rangeKey: range };
-    case "3M":
-      return { interval: "1day", outputsize: 93, rangeKey: range };
-    case "6M":
-      return { interval: "1day", outputsize: 186, rangeKey: range };
-    case "1Y":
-      return { interval: "1day", outputsize: 366, rangeKey: range };
-    case "5Y":
-      return { interval: "1week", outputsize: 261, rangeKey: range };
-    case "ALL":
-      return { interval: "1month", outputsize: 600, rangeKey: range };
-    default:
-      return { interval: "1day", outputsize: 366, rangeKey: range };
-  }
+  const resolution = RANGE_HISTORY_RESOLUTION[range];
+  if (!resolution) return { interval: "1day", outputsize: 366, rangeKey: range };
+  return { interval: toCloudInterval(resolution), outputsize: HISTORY_OUTPUT_SIZE[range], rangeKey: range };
 }

package/src/sources/listing-symbols.ts

@@ -23,7 +23,7 @@ const EXCHANGE_SUFFIX_MAP: Record<string, string> = {
   TASE: ".TA",
   JSE: ".JO",
   BVMF: ".SA", MEXI: ".MX", BYMA: ".BA", BCS: ".SN",
-  TADAWUL: ".SAU", QSE: ".QA", DFM: ".AE",
+  TADAWUL: ".SR", QE: ".QA", DFM: ".AE",
 };
 
 const EXCHANGE_FALLBACKS: Record<string, string[]> = {
@@ -143,11 +143,17 @@ export function listingSuffixExchange(ticker: string): string | undefined {
   return venues.size === 1 ? [...venues][0] : undefined;
 }
 
+/**
+ * A Hong Kong listing's four-digit code. Brokers such as Interactive Brokers
+ * report Tencent as 700 and HSBC as 5; the exchange and market data know
+ * them as 0700 and 0005.
+ */
+export function hongKongListingCode(ticker: string, exchange: string): string {
+  return isHongKongExchange(exchange) && /^\d+$/.test(ticker) ? ticker.padStart(4, "0") : ticker;
+}
+
 function normalizeListingTicker(ticker: string, exchange: string): string {
-  if (isHongKongExchange(exchange) && /^\d+$/.test(ticker)) {
-    return ticker.padStart(4, "0");
-  }
-  return ticker.replace(/ /g, "-");
+  return hongKongListingCode(ticker, exchange).replace(/ /g, "-");
 }
 
 function isHongKongExchange(exchange: string): boolean {