gloomberb 0.18.1 → 0.18.2

package/src/plugins/builtin/buildout/model/index.ts

@@ -1,5 +1,6 @@
 import { apiClient } from "../../../../api-client";
 import { httpFetch } from "../../../../utils/http-transport";
+import { logFailure } from "../../../../utils/log-failure";
 import type {
   BuildoutAccess,
   BuildoutCompaniesPayload,
@@ -55,7 +56,10 @@ export async function buildoutApi<T>(path: string, token: string | null, init: R
   if (token) headers.set("Authorization", `Bearer ${token}`);
   const response = await httpFetch(`${BUILDOUT_API_URL}${path}`, { ...init, headers });
   if (!response.ok) {
-    const body = await response.text().catch(() => "");
+    const body = await response.text().catch(() => {
+      // Intentional ignore: the failed request still throws its status when the error body is unreadable.
+      return "";
+    });
     throw new Error(body || `${BUILDOUT_NAME} request failed (${response.status})`);
   }
   return response.json() as Promise<T>;
@@ -124,12 +128,17 @@ export async function loadBuildoutData(token: string | null) {
 export async function getBuildoutProToken() {
   if (!apiClient.isSignedIn()) return null;
 
-  const session = await apiClient.getSession().catch(() => null);
-  if (!session) return null;
+  try {
+    const session = await apiClient.getSession();
+    if (!session) return null;
 
-  const account = await apiClient.getBuildoutAccount().catch(() => null);
-  if (!account?.subscription.active) return null;
+    const account = await apiClient.getBuildoutAccount();
+    if (!account?.subscription.active) return null;
 
-  const token = await apiClient.getBuildoutToken().catch(() => null);
-  return token?.token ?? null;
+    const token = await apiClient.getBuildoutToken();
+    return token?.token ?? null;
+  } catch (error) {
+    logFailure("buildout.model", "Check access failed")(error);
+    throw new Error("Access check failed. Access is unknown.");
+  }
 }

package/src/plugins/builtin/buildout/pane/index.tsx

@@ -16,6 +16,7 @@ import { handleRefreshKey } from "../../../../components/data-table/table-pane";
 import type { PaneProps } from "../../../../types/plugin";
 import { useOptionalDialog, type PromptContext } from "../../../../ui/dialog";
 import { isPlainKey } from "../../../../utils/keyboard";
+import { logFailure } from "../../../../utils/log-failure";
 import { nextHeaderSort, type SortPreference } from "../../../../utils/sort-values";
 import { usePaneStateValue } from "../../../../state/app/context";
 import { useInlineTickerQuoteFact, useInlineTickers } from "../../../../state/hooks/inline-tickers";
@@ -201,7 +202,7 @@ export function BuildoutPane({ focused, width, height }: PaneProps) {
           choices={openTargets.map((target) => ({ id: target.id, label: target.label, detail: target.detail }))}
         />
       ),
-    }).catch(() => undefined);
+    }).catch(logFailure("buildout.pane", "Choose open target failed"));
     const target = openTargets.find((entry) => entry.id === chosen);
     if (target) openTarget(target);
   }, [dialog, openTarget, openTargets]);
@@ -383,7 +384,7 @@ export function BuildoutPane({ focused, width, height }: PaneProps) {
   }
 
   if (state.status === "error") {
-    return <PaneStatusBody error={state.message} subject={BUILDOUT_NAME} width={width} height={height} />;
+    return <PaneStatusBody error={state.message} subject={BUILDOUT_NAME} width={width} height={height} retry={{ onRetry: refresh }} />;
   }
 
   const listOpen = activeTab === "companies" && !!selectedList;

package/src/plugins/builtin/buildout/pane/status.tsx

@@ -1,4 +1,4 @@
-import { PaneStatusBody, type PaneFooterSegment } from "../../../../components";
+import { delayedFooterSegment, splitDelayedStatus, PaneStatusBody, type PaneFooterSegment } from "../../../../components";
 import type {
   BuildoutList,
   BuildoutLoadState,
@@ -44,10 +44,10 @@ export function updateBuildoutFooterInfo(
 
   const info: PaneFooterSegment[] = [];
   if (messages.quoteFreshness) {
-    info.push({ id: "quote", parts: [{ text: messages.quoteFreshness, tone: "muted" }] });
+    info.push(...splitDelayedStatus({ id: "quote", parts: [{ text: messages.quoteFreshness, tone: "muted" }] }));
   }
   if (state.access !== "pro" && activeTab === "intel") {
-    info.push({ id: "access", onPress: messages.onUpgrade, parts: [{ text: "72h delayed", tone: "warning" }] });
+    info.push(delayedFooterSegment({ id: "access", detail: "72h delayed", delay: "72h", onPress: messages.onUpgrade }));
   }
   if (messages.partialList) {
     info.push({ id: "partial", onPress: messages.onUpgrade, parts: [{ text: "partial list", tone: "warning" }] });

package/src/plugins/builtin/chart-composer/cli-options.ts

@@ -10,6 +10,7 @@ import {
   normalizeChartSpec,
 } from "../../../time-series/spec";
 import type { ChartSeriesSpec, ChartSpec, SeriesPeriod } from "../../../time-series/types";
+import { yearToDateBaseDay } from "../../../market-data/market/year-to-date";
 
 const PRICE_CAPABILITIES = new Set(["price-chart", "intraday-price-chart", "price-comparison"]);
 
@@ -20,6 +21,20 @@ function chartRange(options: HeadlessPaneOptionValues): TimeRange | null {
     : null;
 }
 
+/**
+ * YTD as a window: from the prior year's last session to today, so a return
+ * comparison starts at the close year-to-date returns are measured from (31
+ * Dec 2025 for 2026), never at the year's first session. The earliest of the
+ * charted listings' last December sessions, a venue's own calendar where it
+ * is known.
+ */
+export function yearToDateWindow(spec: ChartSpec, now = Date.now()): { start: string; end: string } {
+  const today = new Date(now).toISOString().slice(0, 10);
+  const venues = [...new Set(spec.series.flatMap((entry) => entry.source.kind === "security" ? [entry.source.instrument.exchange || undefined] : []))];
+  const starts = (venues.length ? venues : [undefined]).flatMap((venue) => yearToDateBaseDay(today, venue, now) ?? []);
+  return { start: starts.sort()[0] ?? `${Number(today.slice(0, 4)) - 1}-12-31`, end: today };
+}
+
 function chartResolution(options: HeadlessPaneOptionValues): ChartResolution | null {
   const value = options.chartResolution ?? options.resolution;
   return typeof value === "string" && (CHART_RESOLUTIONS as readonly string[]).includes(value)
@@ -45,6 +60,10 @@ export function applyChartComposerCapabilityOptions(
   options: HeadlessPaneOptionValues,
 ): ChartSpec {
   let next = spec;
+  if ((options.rangePreset ?? options.range) === "YTD") {
+    // A year of daily bars, shown from the prior year's last close.
+    next = { ...next, viewport: { ...next.viewport, range: "1Y", dateWindow: yearToDateWindow(next) } };
+  }
   const selectedRange = chartRange(options);
   const range = capabilityId === "intraday-price-chart" && typeof options.session === "string"
     ? "1D"

package/src/plugins/builtin/chart-composer/data-catalog-pane.tsx

@@ -42,6 +42,7 @@ import {
 } from "./catalog-inventory";
 import { useCatalogUniverse, useRegisteredSeries } from "./use-series-catalog";
 import { buildRegisteredSeriesChart } from "./presets";
+import { currencyCodeLabel } from "../../../utils/currency-units";
 
 type CatalogColumnId = "series" | "group" | "unit" | "frequency" | "publisher" | "expression";
 type CatalogColumn = DataTableColumn & { id: CatalogColumnId };
@@ -228,7 +229,7 @@ export function DataCatalogPane({ focused, width, height }: PaneProps) {
       case "group":
         return { text: row.group, color: colors.textDim };
       case "unit":
-        return { text: row.unit, color: colors.textDim };
+        return { text: currencyCodeLabel(row.unit), color: colors.textDim };
       case "frequency":
         return { text: FREQUENCY_LABELS[row.frequency], color: colors.textDim };
       case "publisher":

package/src/plugins/builtin/chart-composer/headless-schema.ts

@@ -1,6 +1,6 @@
 import type { HeadlessPaneDefinition, HeadlessPaneOptionDef } from "../../../types/headless";
 import { isSubMinuteInterval, subMinuteDataMessage } from "../../../cli/known-gaps";
-import { FINANCIAL_PERIOD_OPTION, FINANCIAL_PERIOD_COUNT_OPTION, HISTORY_RANGE_VALUES } from "../shared/headless-options";
+import { FINANCIAL_PERIOD_OPTION, FINANCIAL_PERIOD_COUNT_OPTION, HISTORY_RANGE_VALUES, RETURN_RANGE_VALUES } from "../shared/headless-options";
 
 type PaneSchema = Pick<HeadlessPaneDefinition, "argument" | "options" | "discovery">;
 
@@ -111,10 +111,10 @@ export const paneSchemas = {
     options: [
       {
         key: "rangePreset",
-        description: "Price-history window.",
+        description: "Price-history window. YTD runs from the prior year's last close.",
         type: "enum",
         aliases: ["range"],
-        values: HISTORY_RANGE_VALUES,
+        values: RETURN_RANGE_VALUES,
         defaultValue: "1Y",
       },
       {

package/src/plugins/builtin/chart-composer/headless.ts

@@ -232,7 +232,8 @@ export async function loadChartPaneModel(
       ...(chart.priceHistoryIntegrity?.length ? { priceHistoryIntegrity: chart.priceHistoryIntegrity } : {}),
       ...(valuationPriceIssues.length ? { valuationPriceIssues } : {}),
       ...(periodCoverage.length ? { periodCoverage } : {}),
-      notices: [...chart.warnings.filter((warning) => warning === FINANCIAL_VINTAGE_NOTICE || warning === SEC_EPS_BASIS_NOTICE || warning === chart.priceComparison?.notice), ...integrityNotices],
+      notices: [...chart.warnings.filter((warning) => warning === FINANCIAL_VINTAGE_NOTICE || warning === SEC_EPS_BASIS_NOTICE || warning === chart.priceComparison?.notice
+        || chart.delistings?.some((delisting) => delisting.notice === warning)), ...integrityNotices],
       priceComparison: chart.priceComparison ?? null,
       summaries: chart.series.filter((series) => !series.profile).map((series) => ({ id: series.id, ...summarizeResolvedSeries(series) })),
     },

package/src/plugins/builtin/chart-composer/option-range.ts

@@ -0,0 +1,39 @@
+import { useMemo } from "react";
+import { useChartQueries, useResolvedEntryValue } from "../../../market-data/hooks";
+import { instrumentFromTicker, type ChartRequest } from "../../../market-data/request-types";
+import { buildChartKey } from "../../../market-data/selectors";
+import { getTimeRangeForDateWindow } from "../../../time-series/date-window";
+import type { TimeRange } from "../../../time-series/range";
+import type { PricePoint } from "../../../types/financials";
+import type { TickerRecord } from "../../../types/ticker";
+import { resolveOptionsTarget } from "../../../utils/options";
+
+/**
+ * The shortest range that reaches back to a contract's first daily bar. An
+ * option lists months before it expires and may trade a handful of times, so
+ * a stock's five years would hold one bar.
+ */
+function optionChartRange(points: readonly Pick<PricePoint, "date">[], now: number): TimeRange | null {
+  const first = points.reduce<number | null>((oldest, point) => {
+    const time = new Date(point.date).getTime();
+    return Number.isFinite(time) && (oldest === null || time < oldest) ? time : oldest;
+  }, null);
+  if (first === null) return null;
+  const range = getTimeRangeForDateWindow({ start: new Date(first), end: new Date(now) });
+  // A contract that first traded today still opens on a week: one session of minute bars reads as noise.
+  return range === "1D" ? "1W" : range;
+}
+
+/**
+ * The range an option contract's chart opens on, from its own daily history:
+ * a month until that answers, which is most of a weekly's life. Null for
+ * anything that is not an option.
+ */
+export function useOptionChartRange(ticker: TickerRecord | null | undefined): TimeRange | null {
+  const instrument = resolveOptionsTarget(ticker)?.isOptionTicker ? instrumentFromTicker(ticker) : null;
+  const request: ChartRequest | null = instrument
+    ? { instrument, bufferRange: "ALL", granularity: "resolution", resolution: "1d" } : null;
+  const entries = useChartQueries(request ? [request] : []);
+  const history = useResolvedEntryValue(request ? entries.get(buildChartKey(request)) ?? null : null);
+  return useMemo(() => !request ? null : (history?.length ? optionChartRange(history, Date.now()) : null) ?? "1M", [history, !request]);
+}

package/src/plugins/builtin/chart-composer/pane.tsx

@@ -116,6 +116,7 @@ import { resolveChartComposerShortcut } from "./shortcuts";
 import { describeChartResolution, formatChartDateWindow, formatChartResolution } from "./viewport-labels";
 import { intradaySessionTimeZone } from "./session-history";
 import { ChartSeriesQuickAdd } from "./quick-add";
+import { ResearchTradeActions, researchTradeMatches, useResearchTrading } from "../shared/research-trading";
 import { useLiveStreamingSetting } from "../../../state/hooks/live-streaming";
 import { usePluginAppActions, usePluginConfigState } from "../../runtime";
 import { usePluginRenderContext } from "../../runtime/context";
@@ -123,6 +124,7 @@ import { activePriceAlertsFor, addLevelAlert, PRICE_ALERTS_STORE, type AlertTarg
 import { formatAlertDescription } from "../alerts/alert-engine";
 import { alertInstrument, syncAlertQuoteStream } from "../alerts/live";
 import { getSharedMarketDataCoordinator } from "../../../market-data/coordinator";
+import { useOptionChartRange } from "./option-range";
 import { getActiveQuoteDisplay } from "../../../market-data/market/status";
 import { resolveEntryData } from "../../../market-data/selectors";
 import { editPriceLevels, parsePriceLevels, PRICE_LEVELS_KEY, priceLevelTickerKey } from "./price-levels";
@@ -288,6 +290,7 @@ function ChartComposerSurface({
   onCapture,
   nameSeries = true,
 }: ChartComposerSurfaceProps) {
+  const trade = useResearchTrading();
   const dialog = useDialog();
   const dispatch = useAppDispatch();
   const { cellWidthPx = 8 } = useUiCapabilities();
@@ -514,6 +517,7 @@ function ChartComposerSurface({
     return {
       seriesId: listing.seriesId,
       items: [
+        ...(trade && researchTradeMatches(trade, { ...listing.instrument, exchange: listing.target.exchange }) ? trade.levels : []),
         ...stored.map((level) => ({
           id: level.id,
           value: level.price,
@@ -532,7 +536,7 @@ function ChartComposerSurface({
       onEdit: editLevels,
       ...(alertsOn ? { action: { label: "alert", title: "Alert at Level", run: (level) => { void alertAtLevel(level.value); } } } : {}),
     };
-  }, [alertAtLevel, alertsJson, alertsOn, editLevels, levelStore, listing]);
+  }, [alertAtLevel, alertsJson, alertsOn, editLevels, levelStore, listing, trade?.levels, trade?.contract]);
   const [interactionCaptured, setInteractionCapturedState] = useState(false);
   // Typing in quick-add must not freeze the plot: it only takes the keyboard.
   const [modalCaptured, setModalCaptured] = useState(false);
@@ -949,8 +953,15 @@ function ChartComposerSurface({
     ? resolution.legendSeries?.filter((entry) => resolution.priceComparison?.seriesIds.includes(entry.id))
       .map((entry) => `${entry.label}: no observations in the selected date range.`)
     : []);
+  // A charted listing that no longer trades is said in the footer itself: "Delisted Oct 27, 2022" when it
+  // is the chart's one listing, which the title names, else "TWTR: Delisted Oct 27, 2022" for each.
+  const delistings = resolution.delistings;
+  const chartedListings = new Set(spec.series.flatMap((entry) => entry.source.kind === "security" ? [entry.source.instrument.symbol] : []));
+  const delistingKey = delistings?.length === 1 && chartedListings.size === 1 ? delistings[0]!.label
+    : delistings?.map((delisting) => delisting.notice).join(" · ") ?? "";
   const statusWarnings = resolution.warnings.filter((warning) => (
     warning !== FINANCIAL_VINTAGE_NOTICE && warning !== SEC_EPS_BASIS_NOTICE && warning !== comparisonNotice
+    && !delistings?.some((delisting) => delisting.notice === warning)
     && !FORWARD_VALUATION_BASIS_NOTICES.has(warning)
     && !duplicateErrorNotices.has(warning) && !comparisonEmptyNotices.has(warning)
     && !spec.studies.some((study) => (
@@ -1002,21 +1013,26 @@ function ChartComposerSurface({
     return newest > end ? formatCompositeDatasetDate(new Date(newest), end) : null;
   }, [activeRuntimeViewport, plottedSeries, spec, viewport]);
   usePaneFooter(footerId, () => ({
-    info: loading
-      ? [{ id: "loading", parts: [{ text: "loading", tone: "muted" as const }] }]
-      : pickingAnchor
-        ? [{ id: "anchor", parts: [{ text: "pick a bar to anchor VWAP", tone: "muted" as const }] }]
-        : newestBeyondView
-          ? [{ id: "newest", asOf: true, parts: [{ text: `newest ${newestBeyondView}`, tone: "muted" as const }] }]
-          : [],
+    info: [
+      ...(delistingKey ? [{ id: "delisted", parts: [{ text: delistingKey, tone: "warning" as const }] }] : []),
+      ...(loading
+        ? [{ id: "loading", parts: [{ text: "loading", tone: "muted" as const }] }]
+        : pickingAnchor
+          ? [{ id: "anchor", parts: [{ text: "pick a bar to anchor VWAP", tone: "muted" as const }] }]
+          : newestBeyondView
+            ? [{ id: "newest", asOf: true, parts: [{ text: `newest ${newestBeyondView}`, tone: "muted" as const }] }]
+            : []),
+    ],
     hints: [
+      // One key opens the ticket, which chooses Buy or Sell; [s]eries keeps its key with trading on.
+      ...(trade?.available ? [{ id: "trade", key: "t", label: "rade", title: "Open the trade panel", onPress: () => trade.open(), disabled: trade.busy }] : []),
       { id: "series", key: "s", label: "eries", onPress: footerSeries },
       { id: "indicators", key: "i", label: "ndicators", onPress: openIndicators, disabled: indicatorsDisabled },
       { id: "formulas", key: "f", label: "ormulas", onPress: openFormulas, disabled: formulasDisabled },
-      { id: "resolution", key: "t", label: "imeframe", onPress: footerResolution },
+      { id: "resolution", key: "b", label: "ars", title: "Bar Size", onPress: footerResolution },
       ...(anchorable ? [{ id: "vwap-anchor", key: "v", label: "wap anchor", title: "Anchor VWAP", onPress: footerAnchor }] : []),
     ],
-  }), [loading, pickingAnchor, newestBeyondView, footerSeries, openIndicators, indicatorsDisabled, openFormulas, formulasDisabled, footerResolution, anchorable, footerAnchor]);
+  }), [delistingKey, loading, pickingAnchor, newestBeyondView, footerSeries, openIndicators, indicatorsDisabled, openFormulas, formulasDisabled, footerResolution, anchorable, footerAnchor, trade]);
 
   // A fixed window (a GIP session) highlights no range, so the bar names it.
   const dateWindowLabel = useMemo(() => {
@@ -1097,6 +1113,8 @@ function ChartComposerSurface({
 
   return (
     <Box flexDirection="column" width={width} height={height}>
+      {/* Renders nothing: b and s open the trade panel. The query bar keeps the full row. */}
+      <ResearchTradeActions focused={shortcutActive} />
       <QueryBar
         width={width}
         filters={[
@@ -1286,7 +1304,9 @@ export function ChartComposerPane({ paneId, focused, width, height }: PaneProps)
 export function ChartComposerResearchTab({ focused, width, height, onCapture }: TickerResearchTabProps) {
   const { symbol: paneSymbol, ticker } = usePaneTicker();
   const symbol = paneSymbol ? publicTickerKey(paneSymbol, ticker?.metadata.exchange) : null;
-  const fallback = useMemo(() => symbol ? buildPriceChartPreset(symbol) : buildEmptyChartPreset(), [symbol]);
+  // An option contract opens on the range its own history fills; a chart the researcher set keeps its range.
+  const optionRange = useOptionChartRange(ticker);
+  const fallback = useMemo(() => symbol ? buildPriceChartPreset(symbol, optionRange ?? undefined) : buildEmptyChartPreset(), [optionRange, symbol]);
   const [storedSpec, setStoredSpec] = usePaneSettingValue<unknown>(CHART_SPEC_SETTING_KEY, fallback);
   const spec = useMemo(() => parseChartSpecOr(storedSpec, fallback), [fallback, storedSpec]);
   const previousSymbolRef = useRef(symbol);

package/src/plugins/builtin/chart-composer/presets.ts

@@ -222,11 +222,11 @@ function placedRegisteredSeries(expression: ParsedSeriesExpression) {
   };
 }
 
-export function buildPriceChartPreset(symbol: string): ChartSpec {
+export function buildPriceChartPreset(symbol: string, range?: TimeRange): ChartSpec {
   const normalized = normalizeInstrument(symbol, true);
   if (!normalized) return buildEmptyChartPreset();
   return setBuiltinStudies(
-    chartSpec([buildSeriesSpec({ kind: "security", ...normalized, fieldId: CHART_FIELD_IDS.price }, 0)]),
+    chartSpec([buildSeriesSpec({ kind: "security", ...normalized, fieldId: CHART_FIELD_IDS.price }, 0)], { range }),
     ["volume"],
   );
 }

package/src/plugins/builtin/chart-composer/series-catalog.ts

@@ -15,6 +15,7 @@ import {
 } from "../../../utils/exchanges";
 import { parseSeriesExpression, type ParsedSeriesExpression } from "./series-expression";
 import { parseFormulaExpression } from "./formula";
+import { currencyCodeLabel } from "../../../utils/currency-units";
 
 export interface SeriesCatalogInstrument {
   symbol: string;
@@ -351,11 +352,12 @@ function registeredSeriesSuggestions(
   }
   hits.sort((left, right) => left.rank - right.rank || left.entry.name.length - right.entry.name.length);
   return hits.map(({ entry, expression, lines, formula, symbol }): SeriesCatalogSuggestion => {
-    const description = [entry.group, entry.unit, entry.frequency].filter(Boolean).join(" · ");
+    const unit = currencyCodeLabel(entry.unit);
+    const description = [entry.group, unit, entry.frequency].filter(Boolean).join(" · ");
     const detail = entry.group ?? "Series";
     if (formula !== undefined) {
       // A formula runs long: its name leads, and the formula is in the description.
-      const formulaDescription = [formula, entry.unit, entry.frequency].filter(Boolean).join(" · ");
+      const formulaDescription = [formula, unit, entry.frequency].filter(Boolean).join(" · ");
       return { id: `formula:${formula}`, label: entry.name, description: formulaDescription, detail, formula };
     }
     const placed = {

package/src/plugins/builtin/chart-composer/shortcuts.ts

@@ -13,11 +13,11 @@ export function resolveChartComposerShortcut(
 ): ChartComposerShortcut | null {
   if (event.defaultPrevented || event.propagationStopped || event.targetEditable) return null;
 
-  // `r` is the app-wide refresh key, so it reloads here too and the resolution
-  // picker moved to its own mnemonic, [t]imeframe.
+  // `r` is the app-wide refresh key, so it reloads here too, and `t` is Trade
+  // wherever a chart can trade: the resolution picker is [b]ars, the bar size.
   if (isPlainKey(event, "s")) return "series";
   if (isPlainKey(event, "r")) return "reload";
-  if (isPlainKey(event, "t")) return "resolution";
+  if (isPlainKey(event, "b")) return "resolution";
   if (!isPlainKey(event, event.name ?? "")) return null;
 
   const rangeIndex = Number(event.name) - 1;

package/src/plugins/builtin/chart-composer/viewport-labels.ts

@@ -55,7 +55,8 @@ function calendarParts(date: Date, timeZone: string): { key: string; year: numbe
 /**
  * A fixed chart window as the bar states it: one exchange session reads as
  * "Sep 23 session", a longer window as "Sep 17 to Sep 23". Dates are taken in
- * the exchange's zone, so a session that crosses UTC midnight stays one day.
+ * the exchange's zone, so a session that crosses UTC midnight stays one day;
+ * a window of calendar days (YYYY-MM-DD) names those days.
  */
 export function formatChartDateWindow(
   window: { start: string; end: string },
@@ -65,7 +66,9 @@ export function formatChartDateWindow(
   const start = new Date(window.start);
   const end = new Date(window.end);
   if (!Number.isFinite(start.getTime()) || !Number.isFinite(end.getTime())) return undefined;
-  let zone = timeZone;
+  // A window of calendar days (2025-12-31 to 2026-10-20) names those days, not UTC midnight in the exchange's zone.
+  const calendarDays = [window.start, window.end].every((value) => /^\d{4}-\d{2}-\d{2}$/.test(value));
+  let zone = calendarDays ? "UTC" : timeZone;
   try {
     new Intl.DateTimeFormat("en-US", { timeZone: zone });
   } catch {

package/src/plugins/builtin/chat/index.tsx

@@ -136,7 +136,7 @@ export const chatModule: PluginModule = {
     id: UNREAD_INBOX_TEMPLATE_ID,
     paneId: UNREAD_INBOX_PANE_ID,
     label: "Unread",
-    description: "Unread chat, then price alerts, catalysts and team notices you missed",
+    description: "Unread chat, then price alerts, catalysts, economic releases and team notices you missed",
     keywords: ["unread", "chat", "inbox", "mentions", "missed", "notifications", "alerts"],
     createInstance: () => ({
       placement: "floating",

package/src/plugins/builtin/chat/status-widget.tsx

@@ -49,7 +49,7 @@ export function ChatStatusWidget({ controller = chatController }: ChatStatusWidg
   const [username, setUsername] = useState<string | null>(initialSnapshot.user?.username ?? null);
   const [hasSavedSession, setHasSavedSession] = useState(initialSnapshot.hasSavedSession);
   const [snapshot, setSnapshot] = useState(initialSnapshot);
-  // What the Unread list shows as unread: chat, then missed price, catalyst and team notices.
+  // What the Unread list shows as unread: chat, then missed price, catalyst, economic release and team notices.
   const notices = useSyncExternalStore(subscribeNotificationLog, getNotificationLog, getNotificationLog);
   const unreadCount = unreadTotal(snapshot, notices);
 

package/src/plugins/builtin/chat/unread-inbox-pane.tsx

@@ -55,6 +55,7 @@ const COLUMNS: DataTableColumn[] = [
 const NOTICE_LABELS: Record<MissedNoticeKind, string> = {
   price: "Price alert",
   catalyst: "Catalyst",
+  econ: "Economic release",
   team: "Team",
 };
 
@@ -193,7 +194,7 @@ export function UnreadInboxPane({
     });
   }, [createPaneFromTemplate, dispatch, inboxInstanceId, stateRef]);
 
-  // A notice opens where its toast did: the price rule on ALRT Prices, the catalyst, the team card's place.
+  // A notice opens where its toast did: the price rule on ALRT Prices, the catalyst, ECO, the team card's place.
   const openNotice = useCallback((notice: NotificationLogEntry) => {
     const ref = parseNoticeRef(notice.refId);
     if (!ref) return;
@@ -207,6 +208,10 @@ export function UnreadInboxPane({
       createPaneFromTemplate("catalysts-pane", { values: { event: ref.id } });
       return;
     }
+    if (ref.kind === "econ") {
+      showPane("econ-calendar");
+      return;
+    }
     const card = teamStore.getSnapshot().notifications.find((entry) => entry.id === ref.id) ?? null;
     const action = card ? teamStore.notificationAction(card) : null;
     if (action) action.onClick();

package/src/plugins/builtin/chat/unread-inbox.ts

@@ -93,7 +93,7 @@ export function listUnreadInboxItems(options: {
 
 /**
  * A row of the Unread list: a channel with unread chat, or a missed price,
- * catalyst or team notice from the device's log, read or not.
+ * catalyst, economic release or team notice from the device's log, read or not.
  */
 export type UnreadListRow =
   | { kind: "chat"; key: string; item: UnreadInboxItem }

package/src/plugins/builtin/commodity-balances/client.ts

@@ -21,8 +21,10 @@ export interface CommodityBalances {
 const finite = (value: unknown): value is number => typeof value === "number" && Number.isFinite(value);
 const text = (value: unknown): value is string => typeof value === "string";
 
+const MONTH = /^\d{4}-(0[1-9]|1[0-2])$/;
 const validRow = (row: BalanceRow) => [row.id, row.crop, row.country, row.attribute, row.unit, row.year].every(text)
-  && [row.value, row.cropOrder, row.countryOrder, row.attributeOrder].every(finite);
+  && [row.value, row.cropOrder, row.countryOrder, row.attributeOrder].every(finite)
+  && (row.month == null || (text(row.month) && MONTH.test(row.month)));
 const validPrice = (row: PriceForecast) => [row.id, row.crop, row.unit, row.season].every(text)
   && [row.forecast, row.cropOrder, row.seasonYear].every(finite);
 
@@ -31,7 +33,7 @@ function readBoard(payload: PsdBoardPayload): CommodityBalances {
   if (!payload || payload.source !== "USDA" || !Array.isArray(payload.rows) || !Array.isArray(payload.prices)
     || !Array.isArray(payload.gaps) || !payload.gaps.every(text)
     || !payload.rows.every(validRow) || !payload.prices.every(validPrice)
-    || (payload.month != null && !/^\d{4}-(0[1-9]|1[0-2])$/.test(payload.month))
+    || (payload.month != null && !MONTH.test(payload.month))
     || (payload.marketYear != null && !text(payload.marketYear))) {
     throw new Error("The server returned an invalid crop balance board");
   }
@@ -47,8 +49,8 @@ function readBoard(payload: PsdBoardPayload): CommodityBalances {
 }
 
 /**
- * USDA's world wheat, corn, soybean and cotton balances for the latest market
- * year, and the season-average price forecasts. Gloom Cloud reads USDA's
+ * USDA's world wheat, corn, soybean, cotton, coffee and sugar balances for the
+ * latest market year, and the season-average price forecasts. Gloom Cloud reads USDA's
  * files; a route the server does not serve yet (404) or cannot read (503) is
  * the not-available message.
  */

package/src/plugins/builtin/commodity-balances/headless.ts

@@ -1,13 +1,25 @@
 import type { HeadlessPaneDefinition } from "../../../types/plugin";
 import { fetchCommodityBalances } from "./client";
-import { formatBalanceValue, formatForecast } from "./model";
+import { cropEstimateMonth, formatBalanceValue, formatForecast, PSD_CROPS, psdCrop, unknownCropMessage } from "./model";
+
+/**
+ * USDA sets coffee and sugar twice a year, in its own reports rather than the
+ * monthly WASDE, and forecasts no season-average price for either.
+ */
+const SEMIANNUAL_CROPS = new Set(["Coffee", "Sugar"]);
 
 const amount = (value: unknown) => typeof value === "number" ? formatBalanceValue(value) : "--";
 const forecast = (value: unknown) => typeof value === "number" ? formatForecast(value) : "--";
 
 export const commodityBalancesHeadless: HeadlessPaneDefinition<"bundle"> = {
   shape: "bundle",
-  argument: { kind: "none" },
+  argument: {
+    kind: "free-text",
+    optional: true,
+    placeholder: "crop",
+    description: "Wheat, corn, soybeans, cotton, coffee or sugar; omit for every crop.",
+    examples: ["coffee", "sugar"],
+  },
   options: [],
   discovery: {
     aliases: ["PSD"],
@@ -15,18 +27,40 @@ export const commodityBalancesHeadless: HeadlessPaneDefinition<"bundle"> = {
     limitations: [
       "Latest market year only",
       "Largest producers, and the world total when the file has one",
-      "Cotton is in 480 lb bales; grains and soybeans are in thousand metric tons",
+      "Cotton is in 480 lb bales and coffee in thousand 60 kg bags; grains, soybeans and sugar are in thousand metric tons",
+      "Coffee and sugar are USDA's semiannual estimates; price forecasts cover grains, soybeans and cotton",
     ],
   },
-  describe: "Wheat, corn, soybean and cotton balances",
+  describe: "Wheat, corn, soybean, cotton, coffee and sugar balances",
   freshness: { source: "USDA", status: "not-a-feed", basis: "monthly supply and demand estimates", periodicity: "monthly" },
-  async load(_args, ctx) {
-    const data = await fetchCommodityBalances(ctx.signal);
+  async load(args, ctx) {
+    const typed = typeof args.argument === "string" && args.argument.trim() ? args.argument.trim() : null;
+    const crop = typed ? psdCrop(typed) : null;
+    if (typed && !crop) throw new Error(unknownCropMessage(typed));
+    const board = await fetchCommodityBalances(ctx.signal, ctx.apiClient);
+    const rows = crop ? board.rows.filter((row) => row.crop === crop) : board.rows;
+    // A crop the server does not serve yet is said, not printed as an empty table.
+    if (crop && rows.length === 0) throw new Error(`${crop} balances are not available yet.`);
+    const prices = crop ? board.prices.filter((row) => row.crop === crop) : board.prices;
+    // One crop is dated by its own estimates: coffee's are not the month's WASDE.
+    const month = (crop ? cropEstimateMonth(rows) : null) ?? board.month;
+    const marketYear = crop ? [...new Set(rows.map((row) => row.year))].join(" ") : board.marketYear;
+    const semiannual = crop != null && SEMIANNUAL_CROPS.has(crop);
+    // Another crop's gap ("Soybean balances are unavailable.") is not this one's; one naming no crop stays,
+    // but for a crop without price forecasts, not theirs.
+    const names = (name: string, gap: string) => new RegExp(`\\b${name.replace(/s$/, "")}`, "i").test(gap);
+    const gaps = crop
+      ? board.gaps.filter((gap) => names(crop, gap)
+        || (!PSD_CROPS.some((name) => names(name, gap)) && !(semiannual && /\bprice forecasts?\b/i.test(gap))))
+      : board.gaps;
+    const data = { ...board, rows, prices, month, marketYear, gaps };
     return {
+      // Coffee and sugar are not the month's supply and demand estimates: `Jul 2026 (semiannual)`.
+      ...(semiannual ? { freshness: { basis: "supply and distribution estimates", periodicity: "semiannual" as const } } : {}),
       complete: data.rows.length > 0,
       sections: [
         {
-          title: data.marketYear ? `Balances ${data.marketYear}` : "Balances",
+          title: `${crop ? `${crop} balances` : "Balances"}${data.marketYear ? ` ${data.marketYear}` : ""}`,
           columns: [
             { key: "crop", header: "Crop" },
             { key: "country", header: "Country" },

package/src/plugins/builtin/commodity-balances/index.tsx

@@ -1,5 +1,7 @@
 import type { PluginModule } from "../plugin-module";
+import { commandRequestParams } from "../shared/command-tab";
 import { commodityBalancesHeadless } from "./headless";
+import { PSD_CROPS, psdCrop, unknownCropMessage } from "./model";
 import { CommodityBalancesPane } from "./pane";
 
 export const commodityBalancesModule: PluginModule = {
@@ -22,11 +24,24 @@ export const commodityBalancesModule: PluginModule = {
       id: "commodity-balances-pane",
       paneId: "commodity-balances",
       label: "Crop Balances",
-      description: "World balances for wheat, corn, soybeans and cotton, with season-average price forecasts when a table is published.",
-      keywords: ["wheat", "corn", "soybeans", "cotton", "crop", "balances", "production", "exports", "stocks", "harvest"],
-      shortcut: { prefix: "PSD" },
+      description: "World balances for wheat, corn, soybeans, cotton, coffee and sugar, with season-average price forecasts when a table is published.",
+      keywords: ["wheat", "corn", "soybeans", "cotton", "coffee", "sugar", "crop", "balances", "production", "exports", "stocks", "harvest"],
+      shortcut: {
+        prefix: "PSD",
+        argKind: "text",
+        argPlaceholder: "crop",
+        argOptional: true,
+        openWithoutArg: true,
+        argOptions: () => PSD_CROPS.map((crop) => ({ value: crop.toLowerCase(), label: crop })),
+      },
       headless: commodityBalancesHeadless,
-      createInstance: () => ({ placement: "floating" }),
+      // PSD coffee opens the board at coffee's first row.
+      createInstance: (_context, options) => {
+        const typed = options?.arg?.trim();
+        const crop = typed ? psdCrop(typed) : null;
+        if (typed && !crop) throw new Error(unknownCropMessage(typed));
+        return { placement: "floating", ...(crop ? { params: commandRequestParams({ crop }) } : {}) };
+      },
     },
   ],
 };