gloomberb 0.17.2 → 0.17.4

package/src/components/ui/index.ts

@@ -60,7 +60,7 @@ export type { TabsProps } from "./tabs";
 export { SegmentedControl } from "./toggle";
 export type { SegmentedControlProps } from "./toggle";
 export { EmptyState, PaneStatusBody, Notice, loadingText, unavailableText } from "./status";
-export type { EmptyStateProps, PaneStatusBodyProps, NoticeProps } from "./status";
+export type { EmptyStateProps, PaneStatusBodyProps, NoticeProps, StatusRetry } from "./status";
 export { Badge, BulletList, Divider, FigureList, KeyValueRow, Prose, READING_WIDTH, Section, SectionHeading } from "./display";
 export type {
   BadgeProps, BulletListProps, DividerProps, FigureListItem, FigureListProps, KeyValueRowProps, ProseProps, SectionProps,

package/src/components/ui/status.tsx

@@ -1,21 +1,153 @@
-import type { ReactNode } from "react";
+import { useEffect, useReducer, useRef, useState, type ReactNode } from "react";
 import { t, tf } from "../../i18n";
 import { useThemeColors } from "../../theme/theme-context";
 import { Box, Text, useUiCapabilities } from "../../ui";
+import { formatRelativeAge } from "../../utils/datetime-format";
 import { Spinner } from "./loading";
 import { ButtonActionScope } from "./action-scope";
+import { Button } from "./button";
+
+/**
+ * Asking again from an empty or failed state. The state draws the button
+ * (first, so it answers Enter), keeps it busy while the check runs, and when
+ * the answer comes back the same, says when it checked: otherwise a press that
+ * changes nothing on screen looks like a press that did nothing.
+ */
+export interface StatusRetry {
+  /** Asks again. A returned promise keeps the button busy until it settles. */
+  onRetry: () => unknown;
+  /** "Retry", unless the check has a better verb, such as "Look again". */
+  label?: string;
+  /** The label while it runs: "Retrying..." for the default label. */
+  pendingLabel?: string;
+  /**
+   * The same check running from anywhere (the button, `r`, a timer), such as
+   * a resource's `loading`. Needed when the old answer stays on screen while
+   * it runs, as an uncovered company does.
+   */
+  pending?: boolean;
+  /** Said after "Checked just now." when an empty state comes back the same, such as "Still no careers system." */
+  unchanged?: string;
+}
 
 export interface EmptyStateProps {
   title: string;
   message?: string;
   hint?: string;
   actions?: ReactNode;
+  retry?: StatusRetry;
   status?: "empty" | "error";
 }
 
-export function EmptyState({ title, message, hint, actions, status = "empty" }: EmptyStateProps) {
+type ShownStatus = "empty" | "error" | null;
+
+interface RetryFeedback {
+  pending: boolean;
+  press: () => void;
+  /** When a check ended on the state it started from; null once anything else is shown. */
+  checkedAt: number | null;
+}
+
+function isThenable(value: unknown): value is PromiseLike<unknown> {
+  return !!value && typeof (value as PromiseLike<unknown>).then === "function";
+}
+
+/**
+ * A check is the button's own promise, `retry.pending`, or the body showing
+ * its spinner (`shown === "loading"`) once a retry has been offered. When one
+ * ends on the empty or failed state it started from, the answer did not change.
+ */
+function useRetryFeedback(retry: StatusRetry | undefined, shown: ShownStatus | "loading"): RetryFeedback {
+  const [, rerender] = useReducer((count: number) => count + 1, 0);
+  const [checkedAt, setCheckedAt] = useState<number | null>(null);
+  const inFlight = useRef(0);
+  const mounted = useRef(true);
+  const track = useRef<{ offered: boolean; checking: boolean; from: ShownStatus; last: ShownStatus }>({
+    offered: false, checking: false, from: null, last: null,
+  });
+  if (retry) track.current.offered = true;
+  const pending = inFlight.current > 0 || retry?.pending === true;
+  const checking = pending || shown === "loading";
+  const begin = () => {
+    const state = track.current;
+    if (state.checking) return;
+    state.checking = true;
+    state.from = state.last;
+  };
+
+  useEffect(() => {
+    mounted.current = true;
+    return () => { mounted.current = false; };
+  }, []);
+
+  // After every commit: a check that just ended either confirms the state on
+  // screen or clears the line, and anything else shown clears it. A body that
+  // never offered a retry skips all of it.
+  useEffect(() => {
+    const state = track.current;
+    if (!state.offered) return;
+    if (checking) {
+      begin();
+      return;
+    }
+    // `shown` is not "loading" here: that counts as checking.
+    if (state.checking) {
+      state.checking = false;
+      setCheckedAt(shown !== null && shown === state.from ? Date.now() : null);
+    } else if (shown !== state.last) {
+      setCheckedAt(null);
+    }
+    state.last = shown;
+  });
+
+  // "just now" turns into "2m ago" while the line stays up.
+  const shownCheckedAt = checking ? null : checkedAt;
+  useEffect(() => {
+    if (shownCheckedAt === null) return;
+    const timer = setInterval(rerender, 30_000);
+    return () => clearInterval(timer);
+  }, [shownCheckedAt]);
+
+  const press = () => {
+    if (!retry || pending) return;
+    const result = retry.onRetry();
+    if (!isThenable(result)) return;
+    begin();
+    inFlight.current += 1;
+    rerender();
+    const done = () => {
+      inFlight.current -= 1;
+      if (mounted.current) rerender();
+    };
+    result.then(done, done);
+  };
+
+  return { pending, press, checkedAt: shownCheckedAt };
+}
+
+function retryNote(retry: StatusRetry, status: "empty" | "error", checkedAt: number): string {
+  const age = formatRelativeAge(checkedAt, Math.max(checkedAt, Date.now()));
+  if (status === "error") return tf("Tried again {age}.", { age });
+  const checked = tf("Checked {age}.", { age });
+  return retry.unchanged ? `${checked} ${t(retry.unchanged)}` : checked;
+}
+
+export function EmptyState(props: EmptyStateProps) {
+  const feedback = useRetryFeedback(props.retry, props.retry ? props.status ?? "empty" : null);
+  return <EmptyStateBody {...props} feedback={feedback} />;
+}
+
+function EmptyStateBody({ title, message, hint, actions, retry, status = "empty", feedback }: EmptyStateProps & { feedback: RetryFeedback }) {
   const colors = useThemeColors();
   const { nativePaneChrome } = useUiCapabilities();
+  const retryButton = retry ? (
+    <Button
+      label={retry.label ?? "Retry"}
+      pendingLabel={retry.pendingLabel ?? (retry.label ? undefined : "Retrying...")}
+      pending={feedback.pending}
+      onPress={feedback.press}
+    />
+  ) : null;
   // Provider messages must wrap at narrow pane widths rather than lose their tail.
   return (
     <Box flexDirection="column" data-gloom-status={status} data-gloom-ui="empty-state">
@@ -23,11 +155,14 @@ export function EmptyState({ title, message, hint, actions, status = "empty" }:
       {message && <Box><Text fg={colors.textMuted} wrapText>{t(message)}</Text></Box>}
       {hint && <Box><Text fg={colors.textMuted} wrapText>{t(hint)}</Text></Box>}
       {/* Wraps in a narrow pane rather than clipping the second action; a terminal wraps without a blank row. */}
-      {actions && (
+      {(retryButton || actions) && (
         <Box flexDirection="row" flexWrap="wrap" gap={1} rowGap={nativePaneChrome ? undefined : 0} marginTop={1}>
-          <ButtonActionScope>{actions}</ButtonActionScope>
+          <ButtonActionScope>{retryButton}{actions}</ButtonActionScope>
         </Box>
       )}
+      {retry && feedback.checkedAt !== null && (
+        <Box><Text fg={colors.textMuted} wrapText>{retryNote(retry, status, feedback.checkedAt)}</Text></Box>
+      )}
     </Box>
   );
 }
@@ -68,6 +203,8 @@ export interface PaneStatusBodyProps {
   emptyTitle?: string;
   emptyMessage?: string;
   actions?: ReactNode;
+  /** Asking again from the error or empty state; see StatusRetry. */
+  retry?: StatusRetry;
   align?: "start" | "center";
   width?: number;
   height?: number;
@@ -85,12 +222,16 @@ export function PaneStatusBody({
   emptyTitle,
   emptyMessage,
   actions,
+  retry,
   align = "start",
   width,
   height,
   children,
 }: PaneStatusBodyProps) {
   const status = error ? "error" : loading ? "loading" : empty ? "empty" : null;
+  // Here rather than in the state, so a retry that shows the spinner while it
+  // runs still says it tried once the same failure is back.
+  const feedback = useRetryFeedback(retry, status);
   if (!status) return <>{children}</>;
   // Keyed so content that starts with a bare Box never reuses this padded node.
   return (
@@ -107,11 +248,13 @@ export function PaneStatusBody({
       data-gloom-ui="pane-status"
     >
       {status === "loading" ? <Spinner label={loadingLabel ?? loadingText(subject)} /> : (
-        <EmptyState
+        <EmptyStateBody
           status={status}
           title={status === "error" ? errorTitle ?? (subject ? unavailableText(subject) : error!) : emptyTitle ?? t("Nothing to show yet.")}
           message={status === "error" ? (errorTitle || subject ? error! : undefined) : emptyMessage}
           actions={actions}
+          retry={retry}
+          feedback={feedback}
         />
       )}
     </Box>

package/src/data/memory-resource-store.ts

@@ -45,7 +45,7 @@ export class MemoryResourceStore {
       this.delete(key);
       return null;
     }
-    if (options.touch !== false) {
+    if (options.touch !== false && (options.touchIntervalMs == null || Date.now() - record.lastAccessedAt >= options.touchIntervalMs)) {
       record.lastAccessedAt = Date.now();
     }
     record.stale = isStale(record);

package/src/data/resource-store.ts

@@ -63,6 +63,13 @@ export interface GetResourceOptions {
   schemaVersion?: number;
   allowExpired?: boolean;
   touch?: boolean;
+  /**
+   * A read refreshes a row's place in the eviction order, one write per row. A
+   * row read many times a second (a quote, a price history) asks for it at most
+   * once per this many ms, so it stays recent without a write on every read.
+   * `touch: false` never refreshes it, and a row read that way looks old.
+   */
+  touchIntervalMs?: number;
 }
 
 export interface ListResourceOptions extends GetResourceOptions {
@@ -141,6 +148,10 @@ export class ResourceStore {
     });
   }
 
+  private touchDue(record: { lastAccessedAt: number }, options: GetResourceOptions): boolean {
+    return options.touchIntervalMs == null || Date.now() - record.lastAccessedAt >= options.touchIntervalMs;
+  }
+
   private touch(key: ResourceCacheKey): number | null {
     const touchedAt = Date.now();
     const result = trySqliteBusyOperation("touch cached resource", () => {
@@ -283,7 +294,7 @@ export class ResourceStore {
       return null;
     }
 
-    if (options.touch !== false) {
+    if (options.touch !== false && this.touchDue(record, options)) {
       const touchedAt = this.touch(key);
       if (touchedAt != null) {
         record.lastAccessedAt = touchedAt;
@@ -340,6 +351,7 @@ export class ResourceStore {
     }
     if (options.touch !== false) {
       for (const record of records) {
+        if (!this.touchDue(record, options)) continue;
         const touchedAt = this.touch(record);
         if (touchedAt != null) record.lastAccessedAt = touchedAt;
       }

package/src/docs/snapshot.json

@@ -1,7 +1,7 @@
 {
  "format": 1,
  "site": "https://gloom.sh",
- "updatedAt": "2026-10-12",
+ "updatedAt": "2026-10-14",
  "categories": [
   {
    "id": "research",
@@ -618,7 +618,7 @@
    "code": "NI",
    "name": "Topic news",
    "description": "News by topic code or sector",
-   "detail": "Market news by topic code (MNA, CB, ENERGY, REG, CRYPTO, EARN, IPO) or by sector.",
+   "detail": "Market news by topic code (MNA, CB, ENERGY, REG, CRYPTO, EARN, IPO) or by sector. LTR lists public fund and investor letters as links to the publisher's page.",
    "category": "news",
    "arg": "ENERGY",
    "shot": "https://gloom.sh/screenshots/fn/NI.png",
@@ -777,8 +777,8 @@
   {
    "code": "FUT",
    "name": "Futures board",
-   "description": "Front-month futures",
-   "detail": "Front-month contracts across equity index, rates, energy, metals, agriculture, and FX with last price and session change, grouped by sector.",
+   "description": "Most active futures",
+   "detail": "Each root's most active contract across equity index, rates, energy, metals, agriculture, and FX with last price, unit and session change, grouped by sector, naming the nearer month while it still trades.",
    "category": "markets",
    "shot": "https://gloom.sh/screenshots/fn/FUT.png",
    "lesson": "/academy/futures-commodities-energy/futures-from-zero"
@@ -816,7 +816,7 @@
    "code": "POWER",
    "name": "Power and grid buildout",
    "description": "Grid queues and large loads",
-   "detail": "Grid interconnection queues, datacentre and other large-load requests, generation capacity and utility exposure, with a link to the source for every project. Pro shows the full data and history; Free shows three rows per section. EPWR opens the Prices tab, free: day-ahead power prices for 32 European markets in EUR/MWh and the EU carbon (EUA) auction clearing price in EUR/tCO2, each with its daily history.",
+   "detail": "Grid interconnection queues, datacentre and other large-load requests, generation capacity and utility exposure, with a link to the source for every project. Pro shows the full data and history; Free shows three rows per section. EPWR opens the Prices tab, free: day-ahead power prices for 32 European markets in EUR/MWh and the EU carbon (EUA) auction clearing price in EUR/tCO2, each with its daily history. EPWR GAS shows European gas storage from GIE AGSI+: % full, TWh and daily injection and withdrawal for the EU and each member state, against a year ago and the five-year range.",
    "category": "markets",
    "arg": "NEE",
    "access": "pro",
@@ -6329,7 +6329,7 @@
     "developer api",
     "market news"
    ],
-   "updatedAt": "2026-10-07",
+   "updatedAt": "2026-10-14",
    "blocks": [
     {
      "type": "heading",
@@ -6360,7 +6360,7 @@
       [
        "Free key",
        "Free",
-       "Delayed 12 hours."
+       "Delayed 12 hours. Real-time with a paid [Gloom Datasets](/docs/datasets) plan."
       ],
       [
        "Unlimited",
@@ -6380,7 +6380,7 @@
     },
     {
      "type": "paragraph",
-     "text": "Every `/v1/news` request requires a News API key. Use either header style:"
+     "text": "Every `/v1/news` request requires a News API key or a [Gloom Datasets](/docs/datasets) key (`gds_`). Use either header style:"
     },
     {
      "type": "code",
@@ -6595,7 +6595,7 @@
     "cftc",
     "cot"
    ],
-   "updatedAt": "2026-10-08",
+   "updatedAt": "2026-10-14",
    "blocks": [
     {
      "type": "heading",
@@ -6620,7 +6620,7 @@
      "items": [
       "**Alternative data:** GPU rental prices, supply chain, hiring postings and momentum, social mentions, app attention, power and grid, perpetuals, catalysts and litigation, research attention, congressional trades, operating exposure.",
       "**Filings and company text:** KPIs and guidance, executive pay, risk factors, 8-K events, transcripts, credit documents, debt maturities, revenue breakdown, SEC filings, insiders and 13F, document search.",
-      "**News:** Delayed stories, sources and topics.",
+      "**News:** Real-time stories, sources and topics.",
       "**Macro and positioning:** CPI, EIA inventories, COT, yield curves and macro series, central bank rates, short volume and interest, CDS, government awards.",
       "**Market data and fundamentals:** Quotes and history, financial statements, statistics, profiles, earnings, estimates, IPOs, M&A, screener, options and gamma positioning, futures, rate path, crypto, session tape."
      ]
@@ -6644,7 +6644,7 @@
     },
     {
      "type": "paragraph",
-     "text": "They are different keys from the Gloom API's. A Gloom Pro key (`gloom_mcp_`) or a News API key (`gloom_news_`) gets `401 wrong_key` on a dataset route, and a `gds_` key gets `401` on the Gloom API's own routes, such as the [REST API](/docs/rest-api) and the [News API](/docs/news-api)."
+     "text": "They are different keys from the Gloom API's. A Gloom Pro key (`gloom_mcp_`) or a News API key (`gloom_news_`) gets `401 wrong_key` on a dataset route, and a `gds_` key gets `401` on the Gloom API's own routes, such as the [REST API](/docs/rest-api), but reads the [News API](/docs/news-api) at no credit cost."
     },
     {
      "type": "heading",
@@ -7303,9 +7303,9 @@
   {
    "url": "/academy/futures-commodities-energy/futures-from-zero",
    "title": "Futures from zero (FUT)",
-   "summary": "A futures contract is a standard, exchange-traded promise to buy or sell a set quantity on a set month at a price agreed today, settled with daily margin, and FUT shows the front months across markets.",
+   "summary": "A futures contract is a standard, exchange-traded promise to buy or sell a set quantity on a set month at a price agreed today, settled with daily margin, and FUT shows the most active months across markets.",
    "chapter": "Futures, commodities and energy",
-   "minutes": 4
+   "minutes": 5
   },
   {
    "url": "/academy/futures-commodities-energy/curves-and-rolling",

package/src/i18n/es.ts

@@ -982,6 +982,7 @@ export const es: Record<string, string> = {
   "Update ready, restart to apply": "Actualización lista; reinicia para aplicar",
   "Update ready": "Actualización lista",
   "Restart": "Reiniciar",
+  "Restart to apply v{version}": "Reinicia para aplicar v{version}",
   "Checking for updates...": "Buscando actualizaciones...",
   "Downloading v{version}: {percent}%": "Descargando v{version}: {percent}%",
   "Update failed: {error}": "Error al actualizar: {error}",

package/src/i18n/ja.ts

@@ -996,6 +996,7 @@ export const ja: Record<string, string> = {
   "Update ready, restart to apply": "アップデートの準備ができました。適用するには再起動してください",
   "Update ready": "アップデートの準備完了",
   "Restart": "再起動",
+  "Restart to apply v{version}": "再起動して v{version} を適用",
   "Checking for updates...": "アップデートを確認中...",
   "Downloading v{version}: {percent}%": "v{version} をダウンロード中: {percent}%",
   "Update failed: {error}": "更新に失敗しました: {error}",

package/src/i18n/ko.ts

@@ -994,6 +994,7 @@ export const ko: Record<string, string> = {
   "Update ready, restart to apply": "업데이트 준비 완료. 적용하려면 다시 시작하세요",
   "Update ready": "업데이트 준비 완료",
   "Restart": "다시 시작",
+  "Restart to apply v{version}": "다시 시작하여 v{version} 적용",
   "Checking for updates...": "업데이트 확인 중...",
   "Downloading v{version}: {percent}%": "v{version} 다운로드 중: {percent}%",
   "Update failed: {error}": "업데이트 실패: {error}",

package/src/i18n/zh-cn.ts

@@ -996,6 +996,7 @@ export const zhCN: Record<string, string> = {
   "Update ready, restart to apply": "更新已就绪，重启后生效",
   "Update ready": "更新已就绪",
   "Restart": "重启",
+  "Restart to apply v{version}": "重启以应用 v{version}",
   "Checking for updates...": "正在检查更新...",
   "Downloading v{version}: {percent}%": "正在下载 v{version}：{percent}%",
   "Update failed: {error}": "更新失败：{error}",

package/src/i18n/zh-tw.ts

@@ -996,6 +996,7 @@ export const zhTW: Record<string, string> = {
   "Update ready, restart to apply": "更新已就緒，重新啟動後生效",
   "Update ready": "更新已就緒",
   "Restart": "重新啟動",
+  "Restart to apply v{version}": "重新啟動以套用 v{version}",
   "Checking for updates...": "正在檢查更新...",
   "Downloading v{version}: {percent}%": "正在下載 v{version}：{percent}%",
   "Update failed: {error}": "更新失敗：{error}",

package/src/layout-marketplace/gallery-desktop.tsx

@@ -193,7 +193,7 @@ function DiscoverStatus({ controller }: { controller: LayoutGalleryController })
         <EmptyState
           title={discover.state.error}
           status="error"
-          actions={<Button label={t("Retry")} compact onPress={discover.refresh} />}
+          retry={{ onRetry: discover.refresh }}
         />
       </SidebarState>
     );
@@ -219,7 +219,7 @@ function TeamStatus({ controller }: { controller: LayoutGalleryController }) {
         <EmptyState
           title={state.error}
           status="error"
-          actions={<Button label={t("Retry")} compact onPress={refresh} />}
+          retry={{ onRetry: refresh }}
         />
       </SidebarState>
     );

package/src/market-data/futures-board.ts

@@ -1,5 +1,6 @@
 export type FuturesSector =
   | "equity-index"
+  | "equity-sectors"
   | "rates"
   | "energy"
   | "metals"
@@ -38,7 +39,10 @@ export interface FuturesContract {
    * unset: the security keeps the code and the future is its `=F` symbol.
    * Checked with `gloomberb quote <code>` signed out on 2026-10-11: each of
    * these was "Not a ticker", or for ZT and ZF a quote last updated in 2023 and
-   * 2021 that search no longer lists.
+   * 2021 that search no longer lists. The sector, index and energy rows were
+   * checked the same way on 2026-10-14: XAR is an ETF, XAU Goldmoney, SXI
+   * Standex, SXT Sensient, RX BioSyent, EMD a closed-end fund, SOX the PHLX
+   * index, and RS1, MES, MYM, M2K, MCL, MNG and HH are listed abroad.
    */
   bareCode?: true;
 }
@@ -58,6 +62,37 @@ export const FUTURES_CONTRACTS: FuturesContract[] = [
   { symbol: "NQ=F", code: "NQ", name: "E-Mini Nasdaq 100", sector: "equity-index", venue: "CME", tick: 0.25, bareCode: true },
   { symbol: "YM=F", code: "YM", name: "E-Mini Dow", sector: "equity-index", venue: "CBT", tick: 1, bareCode: true },
   { symbol: "RTY=F", code: "RTY", name: "E-Mini Russell 2000", sector: "equity-index", venue: "CME", tick: 0.1, bareCode: true },
+  { symbol: "EMD=F", code: "EMD", name: "E-Mini S&P MidCap 400", sector: "equity-index", venue: "CME", tick: 0.1 },
+  { symbol: "RS1=F", code: "RS1", name: "E-Mini Russell 1000", sector: "equity-index", venue: "CME", tick: 0.1 },
+  { symbol: "NKD=F", code: "NKD", name: "Nikkei 225 (USD)", sector: "equity-index", venue: "CME", tick: 5, bareCode: true },
+  // Quoted in yen: the same index points, each worth 500 yen, so the server has no dollar terms for it.
+  { symbol: "NIY=F", code: "NIY", name: "Nikkei 225 (Yen)", sector: "equity-index", venue: "CME", tick: 5, unit: "index points", bareCode: true },
+  { symbol: "MES=F", code: "MES", name: "Micro E-Mini S&P 500", sector: "equity-index", venue: "CME", tick: 0.25 },
+  { symbol: "MNQ=F", code: "MNQ", name: "Micro E-Mini Nasdaq 100", sector: "equity-index", venue: "CME", tick: 0.25, bareCode: true },
+  { symbol: "MYM=F", code: "MYM", name: "Micro E-Mini Dow", sector: "equity-index", venue: "CBT", tick: 1 },
+  { symbol: "M2K=F", code: "M2K", name: "Micro E-Mini Russell 2000", sector: "equity-index", venue: "CME", tick: 0.1 },
+
+  // CME's E-mini S&P Select Sector futures (XA*) and Select Industry futures
+  // (SX*), named by their S&P index: each sector followed by its industries in
+  // GICS order, then the Dow Jones U.S. Real Estate future on CBOT.
+  { symbol: "XAE=F", code: "XAE", name: "S&P Energy", sector: "equity-sectors", venue: "CME", tick: 0.1, bareCode: true },
+  { symbol: "SXO=F", code: "SXO", name: "S&P Oil & Gas E&P", sector: "equity-sectors", venue: "CME", tick: 0.5, bareCode: true },
+  { symbol: "XAB=F", code: "XAB", name: "S&P Materials", sector: "equity-sectors", venue: "CME", tick: 0.1, bareCode: true },
+  { symbol: "XAI=F", code: "XAI", name: "S&P Industrial", sector: "equity-sectors", venue: "CME", tick: 0.1, bareCode: true },
+  { symbol: "XAY=F", code: "XAY", name: "S&P Consumer Discretionary", sector: "equity-sectors", venue: "CME", tick: 0.1, bareCode: true },
+  { symbol: "SXR=F", code: "SXR", name: "S&P Retail", sector: "equity-sectors", venue: "CME", tick: 1, bareCode: true },
+  { symbol: "XAP=F", code: "XAP", name: "S&P Consumer Staples", sector: "equity-sectors", venue: "CME", tick: 0.1, bareCode: true },
+  { symbol: "XAV=F", code: "XAV", name: "S&P Health Care", sector: "equity-sectors", venue: "CME", tick: 0.1, bareCode: true },
+  { symbol: "SXT=F", code: "SXT", name: "S&P Biotechnology", sector: "equity-sectors", venue: "CME", tick: 1 },
+  { symbol: "XAF=F", code: "XAF", name: "S&P Financial", sector: "equity-sectors", venue: "CME", tick: 0.05, bareCode: true },
+  { symbol: "SXB=F", code: "SXB", name: "S&P Regional Banks", sector: "equity-sectors", venue: "CME", tick: 0.25, bareCode: true },
+  { symbol: "SXI=F", code: "SXI", name: "S&P Insurance", sector: "equity-sectors", venue: "CME", tick: 0.5 },
+  { symbol: "XAK=F", code: "XAK", name: "S&P Technology", sector: "equity-sectors", venue: "CME", tick: 0.1, bareCode: true },
+  { symbol: "SOX=F", code: "SOX", name: "PHLX Semiconductor", sector: "equity-sectors", venue: "CME", tick: 0.5 },
+  { symbol: "XAZ=F", code: "XAZ", name: "S&P Communication Services", sector: "equity-sectors", venue: "CME", tick: 0.05, bareCode: true },
+  { symbol: "XAU=F", code: "XAU", name: "S&P Utilities", sector: "equity-sectors", venue: "CME", tick: 0.1 },
+  { symbol: "XAR=F", code: "XAR", name: "S&P Real Estate", sector: "equity-sectors", venue: "CME", tick: 0.05 },
+  { symbol: "RX=F", code: "RX", name: "Dow Jones U.S. Real Estate", sector: "equity-sectors", venue: "CBT", tick: 0.1 },
 
   { symbol: "ZT=F", code: "ZT", name: "2-Year T-Note", sector: "rates", venue: "CBT", bareCode: true },
   { symbol: "ZF=F", code: "ZF", name: "5-Year T-Note", sector: "rates", venue: "CBT", bareCode: true },
@@ -72,6 +107,12 @@ export const FUTURES_CONTRACTS: FuturesContract[] = [
   { symbol: "TTF=F", code: "TTF", name: "Dutch TTF Gas", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.001, unit: "EUR / MWh", bareCode: true },
   { symbol: "RB=F", code: "RB", name: "RBOB Gasoline", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.0001 },
   { symbol: "HO=F", code: "HO", name: "Heating Oil", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.0001 },
+  // Cash settled on the CL and NG final settlements.
+  { symbol: "QM=F", code: "QM", name: "E-Mini Crude Oil", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.025, bareCode: true },
+  { symbol: "MCL=F", code: "MCL", name: "Micro WTI Crude Oil", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.01 },
+  { symbol: "QG=F", code: "QG", name: "E-Mini Natural Gas", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.005, bareCode: true },
+  { symbol: "MNG=F", code: "MNG", name: "Micro Henry Hub Natural Gas", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.001 },
+  { symbol: "HH=F", code: "HH", name: "Henry Hub Last Day Financial", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.001 },
 
   { symbol: "GC=F", code: "GC", name: "Gold", sector: "metals", venue: "CMX", tick: 0.1 },
   { symbol: "SI=F", code: "SI", name: "Silver", sector: "metals", venue: "CMX", tick: 0.005 },
@@ -109,6 +150,7 @@ export const FUTURES_CONTRACTS: FuturesContract[] = [
 
 export const FUTURES_SECTOR_LABELS: Record<FuturesSector, string> = {
   "equity-index": "Equity Index",
+  "equity-sectors": "Equity Sectors",
   rates: "Rates",
   energy: "Energy",
   metals: "Metals",
@@ -119,6 +161,7 @@ export const FUTURES_SECTOR_LABELS: Record<FuturesSector, string> = {
 
 export const FUTURES_SECTOR_ORDER: FuturesSector[] = [
   "equity-index",
+  "equity-sectors",
   "rates",
   "energy",
   "metals",

package/src/market-data/futures-contract.ts

@@ -128,6 +128,13 @@ export function isFuturesContractSpec(spec: unknown): spec is FuturesContractSpe
     && (row.settlement === "physical" || row.settlement === "cash");
 }
 
+function isNearestContract(value: unknown): boolean {
+  if (!value || typeof value !== "object") return false;
+  const row = value as Record<string, unknown>;
+  return typeof row.contract === "string" && typeof row.contractSymbol === "string"
+    && typeof row.deliveryMonth === "string" && /^\d{4}-(0[1-9]|1[0-2])$/.test(row.deliveryMonth) && optionalDate(row.lastTrade);
+}
+
 export function validateFuturesContractTerms(data: FuturesContractTermsPayload): FuturesContractTermsPayload {
   const settlement = data?.settlement as unknown;
   if (!data || typeof data !== "object" || typeof data.root !== "string"
@@ -138,6 +145,9 @@ export function validateFuturesContractTerms(data: FuturesContractTermsPayload):
       && isDate((settlement as { date?: unknown }).date))) {
     throw new Error("The server returned invalid futures contract terms");
   }
+  // A nearest contract the server worded some other way is left out; the terms still stand.
+  const nearest = data.nearest as unknown;
+  if (nearest != null && !isNearestContract(nearest)) return { ...data, nearest: null };
   return data;
 }
 

package/src/market-data/market/format.ts

@@ -428,7 +428,7 @@ export function formatMarketChangeWithCurrency(
   referencePrice?: number,
 ): string {
   if (value == null || !Number.isFinite(value)) return "—";
-  if (resolvePriceBasis(options.priceBasis, options.assetCategory) !== "per-unit") return formatSignedMarketPrice(value, options);
+  if (isIndexLevel(options) || resolvePriceBasis(options.priceBasis, options.assetCategory) !== "per-unit") return formatSignedMarketPrice(value, options);
   if (options.fixedFractionDigits !== undefined) {
     const maxWidth = options.maxWidth == null ? undefined : Math.max(1, options.maxWidth - 1);
     const body = formatMarketPriceWithCurrency(Math.abs(value), currency, { ...options, maxWidth });
@@ -603,13 +603,18 @@ export function liveQuoteFormatOptions(
   return withStablePriceDigits(quoteFormatOptions(quote, fallbackAssetCategory, metadataInstrumentType), currency, quote);
 }
 
+/** An index level is points, not money: ^GSPC at 7,805.45 has no currency to name, wherever it is shown. */
+function isIndexLevel(options: MarketFormatOptions): boolean {
+  return options.assetCategory?.trim().toUpperCase() === "INDEX";
+}
+
 export function formatMarketPriceWithCurrency(
   value: number | undefined,
   currency = "USD",
   options: MarketFormatOptions = {},
 ): string {
   if (value === undefined || value === null || Number.isNaN(value)) return "—";
-  if (resolvePriceBasis(options.priceBasis, options.assetCategory) !== "per-unit") return formatMarketPrice(value, options);
+  if (isIndexLevel(options) || resolvePriceBasis(options.priceBasis, options.assetCategory) !== "per-unit") return formatMarketPrice(value, options);
   const normalizedCurrency = currency.trim().toUpperCase() || "USD";
   const sign = value < 0 ? "-" : "";
   const symbol = getCurrencySymbol(normalizedCurrency);

package/src/market-data/market/freshness.ts

@@ -1,4 +1,4 @@
-import type { MarketState } from "../../types/financials";
+import type { MarketState, QuoteIndexSession } from "../../types/financials";
 import { canonicalExchange, EXCHANGE_TIME_ZONES, isUsListingExchange } from "../../utils/exchanges";
 import { hasPublishedApacCalendar, isPublishedApacClosure } from "../published-apac-sessions";
 import { hasPublishedCnCalendar, isPublishedCnClosure } from "../published-cn-sessions";
@@ -675,3 +675,27 @@ function isTimestampStaleForExchangeSessionUnsafe(
   }
   return false;
 }
+
+function readSessionWindow(value: unknown): { start: number; end: number } | null {
+  const { start, end } = (value ?? {}) as { start?: unknown; end?: unknown };
+  return typeof start === "number" && typeof end === "number" && Number.isFinite(start) && Number.isFinite(end) && end > start
+    ? { start, end }
+    : null;
+}
+
+/**
+ * The regular sessions an index quote carries, read without trusting the
+ * shape it arrived in: its zone, the session its day follows and the latest
+ * ones. Null when the zone or the current session is missing.
+ */
+export function readIndexSession(value: unknown): QuoteIndexSession | null {
+  const { timeZone, current, regular } = (value ?? {}) as { timeZone?: unknown; current?: unknown; regular?: unknown };
+  const now = readSessionWindow(current);
+  if (typeof timeZone !== "string" || !timeZone.includes("/") || !now) return null;
+  return {
+    timeZone,
+    current: now,
+    // The latest two: the one a print after the close belongs to, and the one before it.
+    regular: Array.isArray(regular) ? regular.flatMap((window) => readSessionWindow(window) ?? []).slice(-2) : [],
+  };
+}