gloomberb 0.16.2 → 0.16.4

package/src/plugins/builtin/portfolio-list/cli/shared.ts

@@ -1,8 +1,6 @@
 import type { AppConfig } from "../../../../types/config";
 import type { CliCommandContext } from "../../../../types/plugin";
-import type { TickerRecord } from "../../../../types/ticker";
 import { parseListingArg, type SavedListingName } from "../../../../cli/listing-arg";
-import { isUsListingExchange } from "../../../../utils/exchanges";
 import { findPortfolio, isManualPortfolio } from "../mutations";
 import { CASH_SYMBOL } from "../allocation";
 
@@ -23,8 +21,8 @@ export function failPortfolioCommand(ctx: CliCommandContext, error: unknown, fal
   return ctx.fail(fallback);
 }
 
-/** What add and remove report about the listing they changed, as JSON and as the sentence's subject. */
-export function listingFields(saved: SavedListingName) {
+/** What every collection command reports about the listing it changed, as JSON and as the sentence's subject. */
+export function listingFields(saved: Pick<SavedListingName, "key" | "symbol" | "exchange" | "name">) {
   return { listing: saved.key, symbol: saved.symbol, exchange: saved.exchange || null, name: saved.name };
 }
 
@@ -72,15 +70,3 @@ export function rejectCashSymbol(symbol: string, exchange: string | undefined, p
     `Record cash with: gloomberb portfolio cash set "${portfolioName}" <amount> [currency]. For the stock that trades as CASH, name its exchange: CASH:NASDAQ.`,
   );
 }
-
-/** `VTI (Vanguard Total Stock Market ETF)`, with the venue and currency for a listing outside the US. */
-export function describeTicker(ticker: TickerRecord): string {
-  const { ticker: symbol, name, exchange, currency } = ticker.metadata;
-  const foreign = !!exchange && !isUsListingExchange(exchange);
-  const details = [
-    name?.trim(),
-    foreign ? exchange : undefined,
-    foreign && currency && currency.toUpperCase() !== "USD" ? currency.toUpperCase() : undefined,
-  ].filter((part): part is string => !!part);
-  return details.length > 0 ? `${symbol} (${details.join(", ")})` : symbol;
-}

package/src/plugins/builtin/portfolio-list/headless.ts

@@ -9,13 +9,18 @@ import type {
 import type { TickerRecord } from "../../../types/ticker";
 import { formatNumber, formatPercentRaw } from "../../../utils/format";
 import {
+  collectionQuoteHeadline,
+  extendedQuoteFields,
+  extendedSessionsOf,
   findCollection,
   loadCollectionQuotes,
   valuePortfolioAllocation,
   valuePortfolioPositions,
   type CollectionMatch,
 } from "./cli/render";
+import { EXTENDED_SESSION_LABELS, type ExtendedSession } from "../../../market-data/market/status";
 import {
+  BROKER_ACCOUNT_MISSING_NOTE,
   CASH_SYMBOL,
   describeTargetSum,
   formatAllocationDrift,
@@ -60,6 +65,7 @@ function textOf(value: unknown): string | undefined {
 const POSITION_COLUMNS: HeadlessPaneColumn[] = [
   { key: "symbol", header: "Ticker" },
   { key: "name", header: "Name" },
+  { key: "exchange", header: "Exchange" },
   { key: "shares", header: "Qty", align: "right", format: quantity },
   { key: "avgCost", header: "Avg Cost", align: "right", format: unitMoney("positionCurrency"), description: "Per unit, in the position's currency." },
   { key: "price", header: "Last", align: "right", format: unitMoney("priceCurrency"), description: "In the quote's currency." },
@@ -78,6 +84,26 @@ const TARGET_COLUMNS: HeadlessPaneColumn[] = [
   { key: "tradeValue", header: "Trade Value", align: "right", format: signedAmount, description: "The trade in the portfolio's currency." },
 ];
 
+/** The pre-market or after-hours print and its move from the regular close, for the rows that have one. */
+function extendedColumn(session: ExtendedSession): HeadlessPaneColumn {
+  return {
+    key: "extendedPrice",
+    header: EXTENDED_SESSION_LABELS[session],
+    align: "right",
+    format: (value, row) => row.extendedSession === session && typeof value === "number"
+      ? `${unitMoney("priceCurrency")(value, row)} ${percent(row.extendedChangePercent)}`
+      : formatNumber(undefined),
+    description: "Measured from the regular close in Last.",
+  };
+}
+
+/** `columns` with an extended column after Chg for each session a row has a print for. */
+function withExtendedColumns(columns: HeadlessPaneColumn[], sessions: readonly ExtendedSession[]): HeadlessPaneColumn[] {
+  if (sessions.length === 0) return columns;
+  const at = columns.findIndex((column) => column.key === "changePercent") + 1;
+  return [...columns.slice(0, at), ...sessions.map(extendedColumn), ...columns.slice(at)];
+}
+
 const WATCHLIST_COLUMNS: HeadlessPaneColumn[] = [
   { key: "symbol", header: "Ticker" },
   { key: "name", header: "Name" },
@@ -153,8 +179,9 @@ async function portfolioHoldings(
   const gross = held.reduce((sum, entry) => sum + Math.abs(finite(entry.row.marketValue) ?? 0), 0);
   const sum = (key: string) => held.reduce((total, entry) => total + (finite(entry.row[key]) ?? 0), 0);
   const seen = new Set<string>();
+  const extendedSessions = extendedSessionsOf(held.map(({ extended }) => extended?.session));
   const rows = held
-    .map(({ ticker, activeQuote, row }) => {
+    .map(({ ticker, headline, extended, row }) => {
       const marketValue = finite(row.marketValue);
       // A ticker held in several lots carries its allocation on its first row.
       const figures = seen.has(ticker.metadata.ticker) ? undefined : allocationBySymbol.get(ticker.metadata.ticker);
@@ -169,9 +196,11 @@ async function portfolioHoldings(
         shares: finite(row.shares),
         avgCost: finite(row.avgCost),
         positionCurrency: row.positionCurrency ?? null,
+        // Last and Chg are the regular session; market value and P&L are at the live price.
         price: finite(row.quotePrice),
         priceCurrency: row.quoteCurrency ?? null,
-        changePercent: finite(activeQuote?.changePercent),
+        changePercent: finite(headline?.changePercent),
+        ...extendedQuoteFields(extended),
         marketValue,
         unrealizedPnl: finite(row.unrealizedPnl),
         weight: figures?.weight ?? null,
@@ -210,11 +239,12 @@ async function portfolioHoldings(
       ? [`${rows.length - limit} more position${rows.length - limit === 1 ? "" : "s"} not shown; totals include every position.`]
       : []),
     ...(targetNote ? [targetNote] : []),
+    ...(target.portfolio.brokerInstanceId && !resolved.account ? [BROKER_ACCOUNT_MISSING_NOTE] : []),
   ];
 
   return {
     freshness: { source: broker ? "Your broker account and Gloom Cloud" : "Local portfolio and Gloom Cloud" },
-    columns: showTargets ? [...POSITION_COLUMNS, ...TARGET_COLUMNS] : POSITION_COLUMNS,
+    columns: withExtendedColumns(showTargets ? [...POSITION_COLUMNS, ...TARGET_COLUMNS] : POSITION_COLUMNS, extendedSessions),
     rows: shown,
     complete: unavailable.length === 0,
     ...(unavailable.length
@@ -252,21 +282,24 @@ async function watchlistHoldings(
   ctx.signal.throwIfAborted();
   const rows = tickers.map((ticker) => {
     const quote = quotes.get(ticker.metadata.ticker);
+    // As the watchlist pane shows it: the regular session, then any extended print from its close.
+    const { headline, extended } = collectionQuoteHeadline(quote);
     return {
       ...quoteFreshnessFields(quote),
       updatedAt: quote?.lastUpdated ?? null,
       symbol: ticker.metadata.ticker,
       name: ticker.metadata.name ?? null,
       exchange: ticker.metadata.exchange || null,
-      price: finite(quote?.price),
+      price: finite(headline?.price ?? quote?.price),
       priceCurrency: quote?.currency ?? null,
-      changePercent: finite(quote?.changePercent),
+      changePercent: finite(headline ? headline.changePercent : quote?.changePercent),
+      ...extendedQuoteFields(extended),
     };
   });
   const shown = rows.slice(0, limit);
   return {
     freshness: { source: "Local watchlist and Gloom Cloud" },
-    columns: WATCHLIST_COLUMNS,
+    columns: withExtendedColumns(WATCHLIST_COLUMNS, extendedSessionsOf(shown.map((row) => row.extendedSession))),
     rows: shown,
     metadata: {
       collection: { kind: "watchlist", id: target.id, name: target.name },
@@ -286,7 +319,7 @@ async function watchlistHoldings(
 export const collectionHoldingsHeadless: HeadlessPaneDefinition<"rows"> = {
   shape: "rows",
   description:
-    "Positions held in a portfolio, broker or manual: symbol, quantity, average cost, last price, market value, unrealized P&L and weight of the total with cash, largest first, then the cash line and totals. With target weights set, each row adds its target, drift and the trade to reach it. For a watchlist, its tickers with quotes. Takes a portfolio or watchlist ID; the first portfolio when omitted.",
+    "Positions held in a portfolio, broker or manual: symbol, exchange, shares, average cost, last price, market value, unrealized P&L and weight of the total with cash, largest first, then the cash line and totals. With target weights set, each row adds its target, drift and the trade to reach it. For a watchlist, its tickers with quotes. Takes a portfolio or watchlist ID; the first portfolio when omitted.",
   discovery: {
     dataRequirements: ["Local portfolios, watchlists and synced broker positions; current quotes"],
     limitations: ["Unrealized P&L on current positions; excludes realized trades, distributions and cash flows"],

package/src/plugins/builtin/portfolio-list/pane/index.tsx

@@ -172,7 +172,8 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
   const flashSymbols = useQuoteFlashMap(financialsMap, valueFlashingEnabled);
 
   const accountStateInput = useMemo(() => ({ brokerAccounts, config }), [brokerAccounts, config]);
-  const { accountState, accountsError } = usePortfolioAccountState(currentPortfolio, accountStateInput);
+  const { accountState, accountsError, brokerError } = usePortfolioAccountState(currentPortfolio, accountStateInput);
+  const brokerPortfolio = isPortfolioTab && !!currentPortfolio?.brokerInstanceId;
   const portfolioTargets = currentPortfolio?.targetWeights;
   const columns = useMemo(
     () => resolveVisibleColumns(paneSettings.columnIds, isPortfolioTab, { targetWeights: hasTargetWeights(currentPortfolio) }),
@@ -338,7 +339,8 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
     currency: totalsCurrency,
     baseCurrency: config.baseCurrency,
     manualCash,
-  }), [config.baseCurrency, convertAccountValue, isPortfolioTab, manualCash, portfolioSummaryTotals, summaryAccountState, totalsCurrency]);
+    brokerPortfolio,
+  }), [brokerPortfolio, config.baseCurrency, convertAccountValue, isPortfolioTab, manualCash, portfolioSummaryTotals, summaryAccountState, totalsCurrency]);
   // The header row sits in the pane's one-cell side padding, like the table.
   const summaryWidth = Math.max(0, width - 2);
   const summaryLayout = useMemo(() => layoutPortfolioSummaryHeader(summarySegments, summaryWidth, {
@@ -476,7 +478,7 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
     accountState: summaryAccountState,
     accountStatusText: accountsError
       ? `Accounts unavailable: ${accountsError}`
-      : isPortfolioTab && currentPortfolio?.brokerInstanceId && !accountState ? "Acct missing" : undefined,
+      : brokerPortfolio ? brokerError ?? (accountState ? undefined : "Acct missing") : undefined,
     financialsMap,
     isPortfolioTab,
     refreshingSize,
@@ -485,7 +487,8 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
   }), [financialsMap, sortedTickers], [
     accountState,
     accountsError,
-    currentPortfolio?.brokerInstanceId,
+    brokerError,
+    brokerPortfolio,
     isPortfolioTab,
     portfolioSummaryTotals,
     refreshingSize,

package/src/plugins/builtin/portfolio-list/summary/index.tsx

@@ -12,6 +12,7 @@ import { displayWidth, formatPercentRaw } from "../../../../utils/format";
 import { getBrokerInstance } from "../../../../utils/broker-instances";
 import {
   resolvePortfolioAccountMetrics,
+  resolvePortfolioLeverage,
   resolvePortfolioMarketValue,
   resolvePortfolioNetLiquidation,
   type BrokerSnapshotBasis,
@@ -223,10 +224,13 @@ export function buildPortfolioSummarySegments({
   currency = "USD",
   baseCurrency = "USD",
   manualCash = null,
+  brokerPortfolio = false,
 }: {
   totals: PortfolioSummaryTotals;
   accountState: PortfolioSummaryAccountState | null;
   isPortfolioTab?: boolean;
+  /** Synced from a broker, so it is worth its account's equity even while the account is missing. */
+  brokerPortfolio?: boolean;
   /** Into the totals currency. */
   convertAccountValue?: (value: number) => number;
   /** The totals currency. */
@@ -249,6 +253,9 @@ export function buildPortfolioSummarySegments({
 
   const candidates: PortfolioSummarySegment[] = [];
   const account = accountState?.account;
+  // A broker account is worth its equity. Its positions alone are its gross,
+  // which margin or shorts put above it, so that sum never reads as its value.
+  const broker = brokerPortfolio || !!account;
   const basis = accountState?.snapshotBasis;
   const accountMetrics = resolvePortfolioAccountMetrics(totals, account, convertAccountValue, basis);
   const totalMarketValue = resolvePortfolioMarketValue(totals, account, convertAccountValue, basis);
@@ -269,15 +276,17 @@ export function buildPortfolioSummarySegments({
     ]));
   }
 
-  if (netLiquidation != null) {
+  // Unknown without the account, so it reads as missing rather than disappearing,
+  // unless cash entered by hand gives the Total above in its place.
+  if (broker && (netLiquidation != null || !manualCash)) {
     candidates.push(createSummarySegment("netliq", [
       { text: "Net Liq", tone: "label" },
-      { text: money(netLiquidation), tone: "value", bold: true },
+      { text: money(netLiquidation ?? Number.NaN), tone: "value", bold: true },
     ]));
   }
 
   candidates.push(createSummarySegment("val", [
-    { text: totals.hasShorts ? "Gross" : "Val", tone: "label" },
+    { text: broker || totals.hasShorts ? "Gross" : "Val", tone: "label" },
     { text: money(totalMarketValue), tone: "value", bold: true },
   ]));
 
@@ -289,7 +298,7 @@ export function buildPortfolioSummarySegments({
   }
 
   // A broker account always states its cash, so a missing balance reads as unknown rather than zero.
-  if (account) candidates.push(accountValue("cash", "Cash", account.totalCashValue ?? Number.NaN)!);
+  if (broker && !manualCash) candidates.push(accountValue("cash", "Cash", account?.totalCashValue ?? Number.NaN)!);
   if (manualCash) {
     const drift = formatAllocationDrift(manualCash.drift);
     candidates.push(createSummarySegment("cash", [
@@ -318,6 +327,14 @@ export function buildPortfolioSummarySegments({
 
   if (!account) return candidates;
 
+  const leverage = resolvePortfolioLeverage(totalMarketValue, netLiquidation);
+  // Only while the account borrows or is short enough to read above 1.0x, as the analytics pane rounds it.
+  const lev = leverage != null && leverage >= 1.05
+    ? createSummarySegment("lev", [
+      { text: "Lev", tone: "label" },
+      { text: `${leverage.toFixed(1)}x`, tone: "value", bold: true },
+    ])
+    : null;
   const realized = accountMetrics.realizedPnl != null
     ? createSummarySegment("realized", [
       { text: "Realized", tone: "label" },
@@ -327,6 +344,7 @@ export function buildPortfolioSummarySegments({
   return [
     ...candidates,
     ...[
+      lev,
       realized,
       accountValue("settled", "Settled", account.settledCash),
       accountValue("avail", "Avail", account.availableFunds),

package/src/plugins/builtin/portfolio-list/summary/live-accounts.ts

@@ -84,6 +84,12 @@ export interface PortfolioAccountStateResult {
   accountState: ResolvedPortfolioAccountState | null;
   /** Set when the broker refused to list accounts, so "no cash" is not mistaken for a clean empty. */
   accountsError: string | null;
+  /**
+   * The broker's last call failed, such as the sync at startup after its
+   * sign-in lapsed. Accounts are listed only while it is connected, so this
+   * is the only word of why the account is missing or stale.
+   */
+  brokerError: string | null;
 }
 
 /**
@@ -111,5 +117,9 @@ export function usePortfolioAccountState(
     () => resolvePortfolioAccountState(portfolio, state, snapshot),
     [portfolio, snapshot, state.brokerAccounts, state.config],
   );
-  return useMemo(() => ({ accountState, accountsError: live.error }), [accountState, live.error]);
+  const brokerError = live.status?.state === "error" ? live.status.message?.trim() || "Broker unavailable" : null;
+  return useMemo(
+    () => ({ accountState, accountsError: live.error, brokerError }),
+    [accountState, brokerError, live.error],
+  );
 }

package/src/plugins/builtin/realized-vol/headless.ts

@@ -46,7 +46,10 @@ export function realizedVolHeadless(initialView: "graph" | "cone"): HeadlessPane
         estimator: ESTIMATOR_OPTIONS.find(({ value }) => value === args.options.estimator)?.value,
         windows, lookbackYears: Number(args.options.lookbackYears) === 2 ? 2 : 1 });
       const errors = [history.error, iv?.error].filter((value): value is string => !!value);
+      // The cone rows are as of the last daily bar, not of when the report ran.
+      const lastBar = model.asOf && Number.isFinite(model.asOf.getTime()) ? model.asOf.toISOString().slice(0, 10) : null;
       return {
+        freshness: { asOf: lastBar },
         sections: [
           { title: "Volatility cone", columns: [
             { key: "window", header: "Sessions" },

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

@@ -164,7 +164,7 @@ export function RealizedVolPane({ width, height, focused }: PaneProps) {
       { id: "estimator", label: "Estimator", value: estimator, options: ESTIMATOR_OPTIONS, onChange: (value: string) => setEstimator(value as RealizedVolatilityEstimator) },
       { id: "lookback", label: "Lookback", value: String(lookback), options: [{ value: "1", label: "1Y" }, { value: "2", label: "2Y" }], onChange: setLookback },
     ]} meta={reference ? `ATM IV observed ${reference.date.toISOString().slice(0, 16).replace("T", " ")} UTC` : "Annualized %"} />
-    {!symbol ? <EmptyState title="Choose a ticker." /> : <PaneStatusBody subject="realized volatility" loading={history.loading && !model}
+    {!symbol ? <EmptyState title="Select a ticker." /> : <PaneStatusBody subject="realized volatility" loading={history.loading && !model}
       error={!model ? history.error ?? identityError ?? null : null} empty={!!model && !model.history.length}>
       {model && view === "cone" ? <>
         <StatGrid items={coneStats} width={width} />

package/src/plugins/builtin/research/corporate-actions-pane.tsx

@@ -25,7 +25,7 @@ import { formatPercent } from "../../../utils/format";
 import { useResolvedEntryValue, useSecFilingDocuments, useSecFilingsQuery } from "../../../market-data/hooks";
 import { instrumentFromTicker } from "../../../market-data/request-types";
 import { usePaneTicker } from "../../../state/app/context";
-import { isUsEquityTicker } from "../../../utils/sec";
+import { mayBeUsEquityTicker } from "../../../utils/sec";
 import { useAssetData, usePluginPaneState } from "../../runtime";
 import { handleRefreshKey } from "../../../components/data-table/table-pane";
 import { SignInWall } from "../cloud/auth-actions";
@@ -496,7 +496,7 @@ export function CorporateActionsView({
     : null;
   const instrument = useMemo(() => instrumentFromTicker(ticker, symbol), [symbol, ticker]);
   const secFilingsEntry = useSecFilingsQuery(
-    openRow?.status === "Earnings" && instrument && isUsEquityTicker(ticker)
+    openRow?.status === "Earnings" && instrument && mayBeUsEquityTicker(ticker)
       ? { instrument, count: SEC_EVENT_FILING_LIMIT }
       : null,
   );

package/src/plugins/builtin/research/equity-diagnostic-pane.tsx

@@ -558,7 +558,7 @@ export function EquityDiagnosticView({ focused, width, height }: {
   // Walls and empty states are drawn straight into the pane, like every other
   // pane's; only a report sits in the padded scroll area.
   if (!symbol) {
-    return <PaneStatusBody empty emptyTitle="No ticker selected." emptyMessage="Move the cursor in a list pane to populate this view." />;
+    return <PaneStatusBody empty emptyTitle="Select a ticker." emptyMessage="Move the cursor in a list pane to populate this view." />;
   }
   if (signInRequired || verificationRequired) {
     return <SignInWall placement="diag-signin" width={width} height={height} symbol={symbol} exchange={exchange} action="run the Equity Diagnostic" needsVerification={verificationRequired} />;

package/src/plugins/builtin/research/relative-valuation-model.ts

@@ -1,5 +1,6 @@
 import { comparablePriceEarnings, notMeaningfulMultiples } from "../../../utils/price-earnings";
 import { selectMarketCapitalization } from "../../../utils/market-capitalization";
+import { reportedEnterpriseValue } from "../../../utils/fundamentals";
 import type { Quote, TickerFinancials } from "../../../types/financials";
 
 export const RELATIVE_VALUATION_STALE_QUOTE_NOTICE = "Quote stale: quote-based values unavailable";
@@ -10,6 +11,9 @@ export function relativeValuationValues(financials: TickerFinancials | null) {
   const fundamentals = financials?.fundamentals;
   const quoteStale = quote?.stale === true;
   const capitalization = selectMarketCapitalization(quoteStale ? undefined : quote, fundamentals);
+  const enterpriseValue = reportedEnterpriseValue(fundamentals);
+  // A zero or non-finite enterprise value is the source's gap, and the ratio it serves beside it comes from the same observation.
+  const enterpriseValueGap = fundamentals?.enterpriseValue != null && enterpriseValue == null;
   const compatibleCurrency = !!fundamentals?.financialCurrency && !!quote?.currency
     && fundamentals.financialCurrency === quote.currency;
   const reportedMultiples = {
@@ -47,11 +51,11 @@ export function relativeValuationValues(financials: TickerFinancials | null) {
     /** Why a multiple is N/M: its earnings base is zero or a loss. */
     notMeaningful,
     // Vendor ADR ratios can mix unverified valuation and reporting units too.
-    evSales: !compatibleCurrency ? null
+    evSales: !compatibleCurrency || enterpriseValueGap ? null
       : fundamentals?.enterpriseToRevenue != null && Number.isFinite(fundamentals.enterpriseToRevenue)
         ? fundamentals.enterpriseToRevenue
-        : fundamentals?.enterpriseValue != null && fundamentals.revenue != null && fundamentals.revenue > 0
-          ? fundamentals.enterpriseValue / fundamentals.revenue : null,
+        : enterpriseValue != null && fundamentals?.revenue != null && fundamentals.revenue > 0
+          ? enterpriseValue / fundamentals.revenue : null,
     fcfYield: capitalization && fundamentals?.financialCurrency === capitalization.currency
       && fundamentals.freeCashFlow != null && Number.isFinite(fundamentals.freeCashFlow) && capitalization.value > 0
       ? fundamentals.freeCashFlow / capitalization.value : null,

package/src/plugins/builtin/revenue-breakdown/client.ts

@@ -4,7 +4,9 @@ import type {
   RevenueBreakdownPayload,
   RevenueBreakdownView,
 } from "../../../api-client/revenue-breakdown";
+import type { IssuerListingParams } from "../../../api-client/paths";
 import { createPluginCache } from "../../../data/plugin-cache";
+import { secListingKey } from "../../../utils/sec";
 
 /**
  * Revenue by product, segment or region comes from Gloom Cloud, which reads
@@ -59,10 +61,12 @@ export async function fetchRevenueBreakdown(
   symbol: string,
   view: RevenueBreakdownView,
   client: Pick<typeof apiClient, "getCloudRevenueBreakdown"> = apiClient,
+  listing?: IssuerListingParams,
 ): Promise<RevenueBreakdownPayload> {
   try {
-    return validateRevenueBreakdown(await client.getCloudRevenueBreakdown(symbol, view));
+    return validateRevenueBreakdown(await client.getCloudRevenueBreakdown(symbol, view, listing));
   } catch (error) {
+    // 404 is also a listing abroad whose company the SEC does not know.
     if (error instanceof ApiRequestError && error.status === 404) throw new Error(NO_BREAKDOWN);
     throw error;
   }
@@ -74,8 +78,9 @@ export interface RevenueResource {
   refreshError: string | null;
 }
 
-const cacheKey = (symbol: string, view: RevenueBreakdownView, pro: boolean) =>
-  `${symbol.toUpperCase()}:${view}:${pro ? "full" : "preview"}`;
+// SAN in Paris is not SAN in New York: a listing abroad is cached under its venue.
+const cacheKey = (symbol: string, view: RevenueBreakdownView, pro: boolean, listing?: IssuerListingParams) =>
+  `${secListingKey(symbol, listing?.exchange)}:${view}:${pro ? "full" : "preview"}`;
 
 // Seeds the first paint while the mount load runs; cache age is not staleness,
 // and a failed refresh reports its own.
@@ -83,8 +88,9 @@ export function cachedRevenueBreakdown(
   symbol: string,
   view: RevenueBreakdownView,
   pro: boolean,
+  listing?: IssuerListingParams,
 ): RevenueResource | null {
-  const cached = revenueBreakdownCache.get(cacheKey(symbol, view, pro), { allowExpired: true });
+  const cached = revenueBreakdownCache.get(cacheKey(symbol, view, pro, listing), { allowExpired: true });
   if (!cached) return null;
   try {
     return { payload: validateRevenueBreakdown(cached.data), stale: false, refreshError: null };
@@ -98,10 +104,11 @@ export async function loadRevenueBreakdown(
   view: RevenueBreakdownView,
   pro: boolean,
   force = false,
+  listing?: IssuerListingParams,
 ): Promise<RevenueResource> {
   const result = await revenueBreakdownCache.load(
-    cacheKey(symbol, view, pro),
-    () => fetchRevenueBreakdown(symbol, view),
+    cacheKey(symbol, view, pro, listing),
+    () => fetchRevenueBreakdown(symbol, view, apiClient, listing),
     { force },
   );
   // A company that stopped reporting a breakdown must not keep showing an old one.

package/src/plugins/builtin/revenue-breakdown/headless.ts

@@ -3,6 +3,7 @@ import type { HeadlessPaneDefinition } from "../../../types/plugin";
 import { fetchRevenueBreakdown } from "./client";
 import { quarterLabel, reportedSpan } from "./model";
 import { SEC_FILINGS } from "../shared/report-freshness";
+import { resolveHeadlessIssuerListing } from "../shared/headless-market-data";
 
 export const revenueBreakdownHeadless: HeadlessPaneDefinition<"bundle"> = {
   shape: "bundle",
@@ -34,10 +35,12 @@ export const revenueBreakdownHeadless: HeadlessPaneDefinition<"bundle"> = {
   ],
   describe: (args) => `Revenue breakdown | ${args.symbols[0]}`,
   async load(args, ctx) {
+    const symbol = args.symbols[0]!;
     const data = reportedSpan(await fetchRevenueBreakdown(
-      args.symbols[0]!,
+      symbol,
       (args.options.view as RevenueBreakdownView | undefined) ?? "product",
       ctx.apiClient,
+      await resolveHeadlessIssuerListing(ctx, symbol),
     ));
     return {
       complete: data.access === "full",

package/src/plugins/builtin/revenue-breakdown/pane.tsx

@@ -30,7 +30,7 @@ import { Blurred, LockedOverlay, UpgradeLabel } from "../shared/locked-rows";
 import { usePaneStatusFooter } from "../../../components/layout/pane/status-footer";
 import { usePlanAccess } from "../../../api-client/plan-access";
 import { useResearchCloudSession } from "../shared/research-cloud-session";
-import { listingIdentity } from "../shared/ticker-request";
+import { listingIdentity, useIssuerListing } from "../shared/ticker-request";
 import { QuarterBars, type BarHover } from "./bars";
 import {
   cachedRevenueBreakdown,
@@ -82,17 +82,20 @@ function RevenueBreakdownView({ width, height, focused }: { width: number; heigh
   const openUpgrade = useCloudUpgradeAction("seg");
   const identity = listingIdentity(boundSymbol, ticker?.metadata.exchange ?? "");
   const symbol = identity?.symbol ?? null;
+  const { name } = useIssuerListing(ticker);
+  const exchange = identity?.exchange ?? "";
+  const listing = useMemo(() => ({ exchange, name }), [exchange, name]);
   const [requestedView, setView] = usePaneSettingValue<RevenueBreakdownView>("view", "product");
   const [mode, setMode] = usePluginPaneState<RevenueMode>("revenue:mode", "trend");
   const [sort, setSort] = usePluginPaneState<RevenueSort>("revenue:sort", { column: "revenue", direction: "desc" });
   const view = REVENUE_VIEWS.includes(requestedView) ? requestedView : "product";
 
   const loader = useCallback(
-    (force: boolean) => loadRevenueBreakdown(symbol!, view, pro, force),
-    [symbol, view, pro, session.requestKey],
+    (force: boolean) => loadRevenueBreakdown(symbol!, view, pro, force, listing),
+    [symbol, listing, view, pro, session.requestKey],
   );
   const resource = useAsyncResource(symbol ? loader : null, {
-    initialData: () => (symbol ? cachedRevenueBreakdown(symbol, view, pro) : null),
+    initialData: () => (symbol ? cachedRevenueBreakdown(symbol, view, pro, listing) : null),
     clearOnError: (error) => error instanceof Error && error.message === NO_BREAKDOWN,
   });
   useAutoRefresh(resource.updatedAt, resource.load);

package/src/plugins/builtin/reverse-dcf/headless.ts

@@ -36,7 +36,11 @@ export const reverseDcfHeadless: HeadlessPaneDefinition<"bundle"> = {
           ...Object.fromEntries(row.implied.map((value, index) => [`t${index}`, implied(value)])) })) },
       ],
       complete: !inputs.stale && !inputs.error && !model.error,
-      ...(inputs.stale ? { freshness: { status: "stale" as const } } : {}),
+      // Dated by the price the enterprise value is marked at, not by when the report ran.
+      freshness: {
+        asOf: inputs.financials?.quote?.lastUpdated ?? null,
+        ...(inputs.stale ? { status: "stale" as const } : {}),
+      },
       unavailableSymbols: model.implied ? [] : [instrument.symbol],
       errors: [inputs.error, model.error].filter((value): value is string => !!value),
       metadata: { currency: model.currency, discountRate, terminalGrowth: TERMINAL_GROWTH, discountRates: DISCOUNT_RATES,

package/src/plugins/builtin/reverse-dcf/model.ts

@@ -1,4 +1,5 @@
 import type { TickerFinancials } from "../../../types/financials";
+import { reportedEnterpriseValue } from "../../../utils/fundamentals";
 
 /** Years of explicit growth before the terminal value. */
 export const FORECAST_YEARS = 10;
@@ -65,7 +66,7 @@ function pastFcfGrowth(financials: TickerFinancials): ReverseDcfModel["pastGrowt
 export function projectReverseDcf(financials: TickerFinancials | null, options: { symbol: string; discountRate: number }): ReverseDcfModel {
   const fundamentals = financials?.fundamentals;
   const currency = fundamentals?.financialCurrency ?? financials?.financialCurrency ?? null;
-  const enterpriseValue = fundamentals?.enterpriseValue ?? null;
+  const enterpriseValue = reportedEnterpriseValue(fundamentals) ?? null;
   const freeCashFlow = fundamentals?.freeCashFlow ?? null;
   const empty: ReverseDcfModel = { symbol: options.symbol, currency, enterpriseValue, freeCashFlow, fcfYield: null, implied: null,
     pastGrowth: financials ? pastFcfGrowth(financials) : null, sensitivity: [], error: null };

package/src/plugins/builtin/reverse-dcf/pane.tsx

@@ -91,7 +91,7 @@ export function ReverseDcfPane({ width, height, focused }: PaneProps) {
 
   return <Box width={width} height={height} flexDirection="column" overflow="hidden">
     <QueryBar width={width} filters={[{ id: "discount", label: "Discount", value: String(discount), options: DISCOUNT_OPTIONS, onChange: setDiscount }]} />
-    {!symbol ? <EmptyState title="Choose a ticker." /> : <PaneStatusBody subject="reverse DCF" loading={inputs.loading && !model}
+    {!symbol ? <EmptyState title="Select a ticker." /> : <PaneStatusBody subject="reverse DCF" loading={inputs.loading && !model}
       error={!model ? inputs.error ?? identityError ?? null : model.error} empty={false}>
       {model && !model.error ? <>
         <StatGrid items={stats} width={width} />

package/src/plugins/builtin/risk-factors/data.ts

@@ -4,7 +4,9 @@ import {
   type CloudRiskReportPayload,
 } from "../../../api-client";
 import { ApiRequestError, isPermanentClientError } from "../../../api-client/errors";
+import { listingAbroad, type IssuerListingParams } from "../../../api-client/paths";
 import type { HeadlessPaneApiClient, PluginPersistence } from "../../../types/plugin";
+import { secListingKey } from "../../../utils/sec";
 
 /** Annual reports are immutable; discovery of newly produced reports is not. */
 const LIST_KIND = "reports";
@@ -88,12 +90,20 @@ function loadCached<T extends object>(
   return request.promise;
 }
 
-export function loadRiskReportsWithClient(client: RiskApiClient, ticker: string, options?: { force?: boolean }): Promise<RiskReportsResult> {
-  const key = ticker.trim().toUpperCase();
+interface RiskLoadOptions {
+  force?: boolean;
+  /** The listing's venue and company, for a listing outside the US. */
+  listing?: IssuerListingParams;
+}
+
+export function loadRiskReportsWithClient(client: RiskApiClient, ticker: string, options?: RiskLoadOptions): Promise<RiskReportsResult> {
+  const symbol = ticker.trim().toUpperCase();
+  // SAN in Paris is not SAN in New York: a listing abroad is cached under its venue.
+  const key = secListingKey(symbol, options?.listing?.exchange);
   return loadCached(client, LIST_KIND, key, activeListFetches, LIST_CACHE_POLICY, options?.force ?? false, async () => {
     let payload: CloudRiskReportListPayload;
     try {
-      payload = await client.getRiskReports(key);
+      payload = await client.getRiskReports(symbol, options?.listing);
     } catch (error) {
       // The list answers 404 when no 10-K risk report is on file (20-F filers, funds).
       if (error instanceof ApiRequestError && error.status === 404) return { company: null, reports: [] };
@@ -104,12 +114,16 @@ export function loadRiskReportsWithClient(client: RiskApiClient, ticker: string,
   });
 }
 
-export function loadRiskReportWithClient(client: RiskApiClient, ticker: string, year: number, options?: { force?: boolean }): Promise<RiskReportResult> {
+export function loadRiskReportWithClient(client: RiskApiClient, ticker: string, year: number, options?: RiskLoadOptions): Promise<RiskReportResult> {
   const symbol = ticker.trim().toUpperCase();
-  return loadCached(client, REPORT_KIND, `${symbol}:${year}`, activeReportFetches, REPORT_CACHE_POLICY, options?.force ?? false, async () => {
-    const payload = await client.getRiskReport(symbol, year);
+  const abroad = listingAbroad(symbol, options?.listing?.exchange) !== null;
+  const key = `${secListingKey(symbol, options?.listing?.exchange)}:${year}`;
+  return loadCached(client, REPORT_KIND, key, activeReportFetches, REPORT_CACHE_POLICY, options?.force ?? false, async () => {
+    const payload = await client.getRiskReport(symbol, year, options?.listing);
     // SEC rows spell share classes BRK-B; a BRK.B request is the same company.
-    const sameTicker = (value: string | undefined) => value?.toUpperCase().replace(/\./g, "-") === symbol.replace(/\./g, "-");
+    // A listing abroad reads its registrant's rows, filed under that
+    // registrant's US ticker (Sanofi's SNY for SAN in Paris).
+    const sameTicker = (value: string | undefined) => abroad || value?.toUpperCase().replace(/\./g, "-") === symbol.replace(/\./g, "-");
     if (!payload || !sameTicker(payload.ticker) || payload.reportYear !== year) {
       throw new Error(`Risk report response does not match ${symbol} ${year}.`);
     }
@@ -117,5 +131,5 @@ export function loadRiskReportWithClient(client: RiskApiClient, ticker: string,
   });
 }
 
-export const loadRiskReports = (ticker: string, options?: { force?: boolean }) => loadRiskReportsWithClient(apiClient, ticker, options);
-export const loadRiskReport = (ticker: string, year: number, options?: { force?: boolean }) => loadRiskReportWithClient(apiClient, ticker, year, options);
+export const loadRiskReports = (ticker: string, options?: RiskLoadOptions) => loadRiskReportsWithClient(apiClient, ticker, options);
+export const loadRiskReport = (ticker: string, year: number, options?: RiskLoadOptions) => loadRiskReportWithClient(apiClient, ticker, year, options);