gloomberb 0.16.6 → 0.17.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gloomberb",
-  "version": "0.16.6",
+  "version": "0.17.1",
   "packageManager": "bun@1.3.11",
   "description": "Market research and portfolio tracker for the terminal",
   "module": "src/public/index.ts",
@@ -85,6 +85,7 @@
     "check:pane-chrome": "bun run scripts/pane-chrome/checks.ts",
     "check:pane-screenshot": "bun run scripts/pane-chrome/screenshot.ts",
     "check:pane-rest": "bun run scripts/pane-chrome/rest-diff.ts",
+    "check:pane-layout": "bun run scripts/pane-chrome/layout-sweep.ts",
     "benchmark:pane-drag:compare": "bun run scripts/pane-chrome/frame-budget.ts",
     "test:global-upgrade": "bun run scripts/smoke-global-upgrade.ts",
     "release": "./scripts/release.sh"

package/src/api-client/chat-pane-link.ts

@@ -0,0 +1,47 @@
+/**
+ * What a chat message opens in the terminal beside its text, as the server
+ * sends it: the news story a Gloom Wire headline names, the calendar a morning
+ * post reads from. Only the server writes it, from ids it already resolved.
+ * A kind this version does not know, or a malformed one, reads as absent and
+ * the message is plain text, as it is for a server that predates the field.
+ */
+export type ChatPaneLink =
+  | { kind: "news-story"; storyId: string }
+  | { kind: "economic-calendar"; date: string }
+  | { kind: "earnings-calendar"; date: string }
+  | { kind: "ipo-calendar"; date: string }
+  | { kind: "energy-report"; report: "petroleum" | "gas"; weekEnding: string };
+
+const STORY_ID = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/;
+const DATE = /^\d{4}-\d{2}-\d{2}$/;
+const DATED_KINDS: ReadonlySet<string> = new Set(["economic-calendar", "earnings-calendar", "ipo-calendar"]);
+
+function isCalendarDate(value: unknown): value is string {
+  if (typeof value !== "string" || !DATE.test(value)) return false;
+  const date = new Date(`${value}T00:00:00Z`);
+  return Number.isFinite(date.getTime()) && date.toISOString().startsWith(value);
+}
+
+export function parseChatPaneLink(value: unknown): ChatPaneLink | null {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const link = value as Record<string, unknown>;
+  const keys = Object.keys(link).sort().join(",");
+  if (link.kind === "news-story") {
+    return keys === "kind,storyId" && typeof link.storyId === "string" && STORY_ID.test(link.storyId)
+      ? { kind: "news-story", storyId: link.storyId }
+      : null;
+  }
+  if (typeof link.kind === "string" && DATED_KINDS.has(link.kind)) {
+    return keys === "date,kind" && isCalendarDate(link.date)
+      ? { kind: link.kind, date: link.date } as ChatPaneLink
+      : null;
+  }
+  if (link.kind === "energy-report") {
+    return keys === "kind,report,weekEnding"
+      && (link.report === "petroleum" || link.report === "gas")
+      && isCalendarDate(link.weekEnding)
+      ? { kind: "energy-report", report: link.report, weekEnding: link.weekEnding }
+      : null;
+  }
+  return null;
+}

package/src/api-client/chat.ts

@@ -19,6 +19,7 @@ import type {
   ChatStateResponse,
 } from "./types";
 import type { CloudApiRequest } from "./request";
+import { localUtcOffsetMinutes } from "../utils/local-utc-offset";
 type ChatNotificationListener = (notification: ChatNotification) => void;
 type ChatPresenceListener = (onlineCount: number) => void;
 
@@ -127,8 +128,15 @@ export class CloudChatApi {
     return this.request<{ onlineCount: number }>("/chat/presence");
   }
 
+  /**
+   * Channels, unread counts and pending notifications. It also reports this
+   * machine's current offset from UTC, so the card others open on you shows
+   * your local time; a server that predates it ignores the parameter.
+   */
   async getState(): Promise<ChatStateResponse> {
-    const state = await this.request<ChatStateResponse>("/chat/state");
+    const offset = localUtcOffsetMinutes();
+    const query = offset === null ? "" : `?${new URLSearchParams({ utcOffset: String(offset) })}`;
+    const state = await this.request<ChatStateResponse>(`/chat/state${query}`);
     this.noteMessages((state.notifications ?? []).map((notification) => notification?.message));
     return normalizeChatState(state);
   }

package/src/api-client/data.ts

@@ -23,8 +23,10 @@ import {
   type GoingConcernParams,
   type InsolvencyNoticesParams,
 } from "./distress";
+import type { LettersParams } from "./letters";
 import type { IpoCalendarParams, IpoCalendarPayload } from "./ipo";
 import type { TickerChanges } from "../types/ticker-changes";
+import type { OrganizationTickersResponse } from "./organization-tickers";
 import type { CryptoMarketsPayload } from "./crypto-markets";
 import type { CentralBankRatesPayload } from "./central-bank-rates";
 import type { EstimateRevisionsPayload } from "./estimate-revisions";
@@ -36,8 +38,8 @@ import type { BeneficialOwnersPayload, CloudBeneficialOwnersParams } from "./ben
 import type { SocialMentionDayPosts, SocialMentionsPayload, SocialMentionsRange } from "./social-mentions";
 import type { FuturesContractTermsPayload, FuturesCurveAsOfPayload, FuturesCurvePayload } from "./futures-curve";
 import type { CotBoardPayload, CotContractPayload, CotFamily, CotClass } from "./cot";
-import type { DoeBoardPayload } from "./doe";
-import type { CarbonBoard, CarbonHistory, EuropePowerBoard, EuropePowerHistory } from "./europe-energy";
+import type { DoeBoardPayload, DoePricesPayload } from "./doe";
+import type { CarbonBoard, CarbonHistory, EuropePowerBoard, EuropePowerHistory, GasStorageBoard, GasStorageHistory, GasStorageSeasonal } from "./europe-energy";
 import type { GpuBoardPayload, GpuEventsPayload, GpuHistoryPayload, GpuHistoryQuery } from "./gpu";
 import type { CpiBoardPayload } from "./cpi";
 import type { TapeSnapshot } from "./tape";
@@ -388,6 +390,15 @@ export class CloudDataApi {
     );
   }
 
+  /** The listed company each organization name resolves to, if any: a trial's lead sponsors, a page at a time. */
+  async getCloudOrganizationTickers(names: readonly string[], signal?: AbortSignal): Promise<OrganizationTickersResponse> {
+    return this.request<OrganizationTickersResponse>("/market/organization-tickers", {
+      method: "POST",
+      body: JSON.stringify({ names }),
+      signal,
+    });
+  }
+
   async getCloudHistory(
     symbol: string,
     exchange: string,
@@ -575,6 +586,10 @@ export class CloudDataApi {
     return this.request<DoeBoardPayload>("/cloud/doe/board");
   }
 
+  async getCloudDoePrices(): Promise<DoePricesPayload> {
+    return this.request<DoePricesPayload>("/cloud/doe/prices");
+  }
+
   async getCloudAttention(window: AttentionWindow = "now", symbol?: string): Promise<AttentionPayload> {
     const path = symbol ? `/cloud/attention/${encodeURIComponent(symbol)}` : "/cloud/attention";
     return this.request<AttentionPayload>(`${path}?window=${window}`);
@@ -620,6 +635,25 @@ export class CloudDataApi {
     return this.request<CarbonHistory>(`/cloud/europe-energy/carbon/history${query}`, { signal: AbortSignal.timeout(30_000) });
   }
 
+  /** European gas storage: the EU aggregate and each member state as of its latest gas day. */
+  async getCloudEuropeGas(): Promise<GasStorageBoard> {
+    return this.request<GasStorageBoard>("/cloud/europe-energy/gas", { signal: AbortSignal.timeout(30_000) });
+  }
+
+  /** One area's gas days from `from` (all kept without one), oldest first. */
+  async getCloudEuropeGasHistory(code: string, from?: string | null): Promise<GasStorageHistory> {
+    const query = from ? `?${new URLSearchParams({ from })}` : "";
+    return this.request<GasStorageHistory>(
+      `/cloud/europe-energy/gas/${encodeURIComponent(code)}/history${query}`,
+      { signal: AbortSignal.timeout(30_000) },
+    );
+  }
+
+  /** One area's latest year against last year and its five-year range, day by day. */
+  async getCloudEuropeGasSeasonal(code: string): Promise<GasStorageSeasonal> {
+    return this.request<GasStorageSeasonal>(`/cloud/europe-energy/gas/${encodeURIComponent(code)}/seasonal`, { signal: AbortSignal.timeout(30_000) });
+  }
+
   async getCloudGpuBoard(): Promise<GpuBoardPayload> {
     return this.request<GpuBoardPayload>("/cloud/gpu/board");
   }
@@ -727,6 +761,12 @@ export class CloudDataApi {
     return this.request<unknown>(`/public/insolvency-notices${distressQuery(params)}`, { signal: signalWithTimeout(options?.signal, 30_000) });
   }
 
+  async getPublicLetters(params: LettersParams = {}, options?: { signal?: AbortSignal }): Promise<unknown> {
+    const { kinds, ...rest } = params;
+    const query = distressQuery({ kind: kinds?.length ? kinds.join(",") : undefined, ...rest });
+    return this.request<unknown>(`/public/letters${query}`, { signal: signalWithTimeout(options?.signal, 30_000) });
+  }
+
   async getCloudIpoCalendar(params: IpoCalendarParams = {}, options?: { signal?: AbortSignal }): Promise<IpoCalendarPayload> {
     const query = new URLSearchParams();
     for (const [key, value] of Object.entries(params)) {

package/src/api-client/doe.ts

@@ -73,3 +73,22 @@ export interface DoeBoardPayload {
   reports: DoeReportStatus[];
   series: DoeSeriesRow[];
 }
+
+/** One EIA weekly US retail price series, as GET /cloud/doe/prices serves it. */
+interface DoePriceSeries {
+  id: string;
+  /** The EIA source key, which a report cites. */
+  key: string;
+  label: string;
+  unit: "usd-per-gallon";
+  /** [Monday the EIA surveyed, dollars per gallon], oldest first, the last five years. */
+  points: Array<[string, number]>;
+}
+
+export interface DoePricesPayload {
+  source: "EIA";
+  generatedAt: string;
+  status: "available" | "partial" | "unavailable";
+  gaps: string[];
+  series: DoePriceSeries[];
+}

package/src/api-client/equity-screener.ts

@@ -38,6 +38,7 @@ export const NUMERIC_FIELDS = [
   "return1YPercent",
   "fromHigh52WPercent",
   "beta",
+  "atrPercent",
   "priceToBook",
   "evToEbitda",
   "roePercent",
@@ -58,6 +59,8 @@ export const RESEARCH_FIELDS = [
   "return1WPercent", "return1MPercent", "return3MPercent", "returnYtdPercent", "return1YPercent", "fromHigh52WPercent",
   "beta", "priceToBook", "evToEbitda", "roePercent", "epsRevision30dPercent", "analystUpsidePercent", "ivRank", "ivToHv",
 ] as const;
+/** Average true range as a percent of price; listed only when asked (`include=volatility`), and omitted by a server from before it. */
+export const VOLATILITY_FIELDS = ["atrPercent"] as const;
 export const CATEGORY_FIELDS = [
   "symbol",
   "exchange",

package/src/api-client/europe-energy.ts

@@ -104,3 +104,94 @@ export interface CarbonHistory {
   /** Each auction day's price, oldest first. */
   points: Array<{ date: string; value: number }>;
 }
+
+/** Percent full, TWh in storage, GWh/day flows: as GIE AGSI+ publishes them. */
+interface GasStorageUnits {
+  full: "%";
+  storage: "TWh";
+  flow: "GWh/day";
+}
+
+/** The platform's own flag for a gas day. */
+type GasReadingStatus = "estimated" | "confirmed";
+
+/** Fullness on the same calendar day in the five years before the gas day's own; fewer where history is short. */
+interface GasFiveYear {
+  years: number[];
+  min: number;
+  max: number;
+  average: number;
+  /** Percentage points against the average. */
+  vsAverage: number;
+  /** 0 at the low, 100 at the high, beyond either outside the range; null under two years. */
+  position: number | null;
+}
+
+/** One area's latest gas day with a reading: the EU aggregate or a member state. */
+export interface GasStorageRow {
+  /** EU, or ISO 3166 alpha-2. */
+  code: string;
+  name: string;
+  /** The gas day, dated by its start. */
+  gasDay: string | null;
+  status: GasReadingStatus | null;
+  /** Percent of working gas volume. */
+  full: number | null;
+  /** TWh. */
+  gasInStorage: number | null;
+  workingGasVolume: number | null;
+  /** GWh/day. */
+  injection: number | null;
+  withdrawal: number | null;
+  previousGasDay: string | null;
+  /** Percentage points against the gas day before. */
+  change: number | null;
+  yearAgo: { gasDay: string; full: number; gasInStorage: number | null; change: number } | null;
+  fiveYear: GasFiveYear | null;
+  /** Fullness at the end of each week of the year to `gasDay`, oldest first. */
+  trail: Array<{ date: string; value: number }>;
+}
+
+export interface GasStorageBoard {
+  generatedAt: string;
+  status: "available" | "unavailable";
+  units: GasStorageUnits;
+  source: { name: string; url: string };
+  /** When every area was last read from the platform. */
+  checkedAt: string | null;
+  gaps: string[];
+  /** The EU aggregate first, then the member states by name. */
+  rows: GasStorageRow[];
+}
+
+export interface GasStorageHistory {
+  code: string;
+  name: string;
+  units: GasStorageUnits;
+  source: { name: string; url: string };
+  /** Every gas day with a reading, oldest first; a missing figure is null, never zero. */
+  points: Array<{
+    date: string;
+    status: GasReadingStatus;
+    full: number | null;
+    gasInStorage: number | null;
+    workingGasVolume: number | null;
+    injection: number | null;
+    withdrawal: number | null;
+  }>;
+}
+
+/** The latest gas day's calendar year against last year and the five years before, on that year's calendar. */
+export interface GasStorageSeasonal {
+  code: string;
+  name: string;
+  unit: "%";
+  source: { name: string; url: string };
+  year: number | null;
+  /** The band years holding any reading. */
+  years: number[];
+  current: Array<[string, number]>;
+  previous: Array<[string, number]>;
+  /** [date, min, average, max, years with a reading]. */
+  band: Array<[string, number | null, number | null, number | null, number]>;
+}

package/src/api-client/index.ts

@@ -40,6 +40,7 @@ import type {
 
 export { setCloudApiFetchTransport, setCloudApiUploadTransport } from "./request";
 export type { ChatAttachmentUpload } from "./chat";
+export type { ChatPaneLink } from "./chat-pane-link";
 export { NoteConflictError } from "./notes";
 export { ThesisConflictError, ThesisGoalpostError } from "./theses";
 export { TeamRevisionConflictError } from "./views";
@@ -741,6 +742,7 @@ class GloomApiClient {
   getCloudAnalystResearch = this.data.getCloudAnalystResearch.bind(this.data);
   getCloudCorporateActions = this.data.getCloudCorporateActions.bind(this.data);
   getCloudTickerChanges = this.data.getCloudTickerChanges.bind(this.data);
+  getCloudOrganizationTickers = this.data.getCloudOrganizationTickers.bind(this.data);
   getCloudHistory = this.data.getCloudHistory.bind(this.data);
   getCloudExchangeRate = this.data.getCloudExchangeRate.bind(this.data);
   getCloudEconomicCalendar = this.data.getCloudEconomicCalendar.bind(this.data);
@@ -772,6 +774,7 @@ class GloomApiClient {
   getPublicGoingConcern = this.data.getPublicGoingConcern.bind(this.data);
   getPublicDistressDesignations = this.data.getPublicDistressDesignations.bind(this.data);
   getPublicInsolvencyNotices = this.data.getPublicInsolvencyNotices.bind(this.data);
+  getPublicLetters = this.data.getPublicLetters.bind(this.data);
   getCloudIpoCalendar = this.data.getCloudIpoCalendar.bind(this.data);
   getCloudShortVolume = this.data.getCloudShortVolume.bind(this.data);
   getCloudSocialMentions = this.data.getCloudSocialMentions.bind(this.data);
@@ -809,6 +812,7 @@ class GloomApiClient {
   getCloudAwards = this.data.getCloudAwards.bind(this.data);
   getCloudAward = this.data.getCloudAward.bind(this.data);
   getCloudDoeBoard = this.data.getCloudDoeBoard.bind(this.data);
+  getCloudDoePrices = this.data.getCloudDoePrices.bind(this.data);
   getCloudAttention = this.data.getCloudAttention.bind(this.data);
   getCloudPowerBoard = this.data.getCloudPowerBoard.bind(this.data);
   getCloudPowerHistory = this.data.getCloudPowerHistory.bind(this.data);
@@ -817,6 +821,9 @@ class GloomApiClient {
   getCloudEuropePowerHistory = this.data.getCloudEuropePowerHistory.bind(this.data);
   getCloudEuropeCarbon = this.data.getCloudEuropeCarbon.bind(this.data);
   getCloudEuropeCarbonHistory = this.data.getCloudEuropeCarbonHistory.bind(this.data);
+  getCloudEuropeGas = this.data.getCloudEuropeGas.bind(this.data);
+  getCloudEuropeGasHistory = this.data.getCloudEuropeGasHistory.bind(this.data);
+  getCloudEuropeGasSeasonal = this.data.getCloudEuropeGasSeasonal.bind(this.data);
   getCloudGpuBoard = this.data.getCloudGpuBoard.bind(this.data);
   getCloudGpuHistory = this.data.getCloudGpuHistory.bind(this.data);
   getCloudGpuEvents = this.data.getCloudGpuEvents.bind(this.data);

package/src/api-client/letters.ts

@@ -0,0 +1,41 @@
+/**
+ * Public fund and investor letters: a link-only list of each letter's title,
+ * who wrote it, when, what kind it is and where its publisher keeps it. The
+ * route is anonymous; the Letters code of Topic News parses the answer before
+ * drawing anything.
+ */
+export type LetterKind = "shareholder_letter" | "memo" | "commentary" | "annual_report";
+
+/**
+ * What a letter's date is: the date its publisher states, its EDGAR filing
+ * date, or the last change of its document file (for publishers whose pages
+ * give no date), which is not a publication date.
+ */
+export type LetterDateBasis = "published" | "filed" | "file_modified";
+
+export interface LettersParams {
+  /** Any of these kinds, sent as one comma-separated `kind`; every kind when absent. */
+  kinds?: readonly LetterKind[];
+  /** 1 to 200. */
+  limit?: number;
+  offset?: number;
+}
+
+export interface Letter {
+  id: string;
+  title: string;
+  entity: string;
+  kind: LetterKind;
+  /** `YYYY-MM-DD`; `date_basis` says what it is. */
+  date: string;
+  date_basis: LetterDateBasis;
+  /** The publisher's own page or file. */
+  url: string;
+}
+
+export interface LettersPayload {
+  items: Letter[];
+  hasMore: boolean;
+  limit: number;
+  offset: number;
+}

package/src/api-client/normalizers.ts

@@ -9,6 +9,8 @@ import type {
   ChatReaction,
   ChatReactionUser,
   ChatStateResponse,
+  ChatUserBadge,
+  ChatUserSummary,
   CloudSavedSearch,
   CloudSearchHit,
   CloudSearchResponse,
@@ -17,6 +19,7 @@ import type {
   TeamNotification,
 } from "./types";
 import { normalizeTimestamp } from "../utils/timestamp";
+import { parseChatPaneLink } from "./chat-pane-link";
 
 /**
  * Saved-search writes answer with either the record itself or `{ search }`.
@@ -82,17 +85,37 @@ export function normalizeChatAttachments(value: unknown): ChatAttachment[] {
 const CHAT_ACCOUNT_TYPES: readonly string[] = ["human", "managed_llm", "discord"] satisfies ChatAccountType[];
 const CHAT_MESSAGE_ORIGINS: readonly string[] = ["app", "discord"] satisfies ChatMessageOrigin[];
 
-/** A value a newer server adds that this client does not know reads as absent: a human, a message from the app. */
-function chatUserWithKnownAccountType(user: ChatMessage["user"]): ChatMessage["user"] {
-  if (!user || user.accountType === undefined || CHAT_ACCOUNT_TYPES.includes(user.accountType)) return user;
-  const { accountType: _unknown, ...known } = user;
-  return known;
+const CHAT_USER_BADGES: readonly string[] = ["team", "pro"] satisfies ChatUserBadge[];
+
+/**
+ * A value a newer server adds that this client does not know reads as absent:
+ * a human, a message from the app, no badge. A clock or desks that are not
+ * what the server promises are dropped rather than shown wrong.
+ */
+function normalizeChatUser(user: ChatUserSummary): ChatUserSummary {
+  if (!user || typeof user !== "object") return user;
+  const { accountType, badges, utcOffsetMinutes, desks, ...rest } = user;
+  const knownBadges = Array.isArray(badges)
+    ? CHAT_USER_BADGES.filter((badge) => badges.includes(badge as ChatUserBadge)) as ChatUserBadge[]
+    : [];
+  const knownDesks = Array.isArray(desks) ? desks.filter((desk): desk is string => typeof desk === "string" && !!desk) : [];
+  const offset = typeof utcOffsetMinutes === "number" && Number.isInteger(utcOffsetMinutes)
+    && utcOffsetMinutes >= -12 * 60 && utcOffsetMinutes <= 14 * 60
+    ? utcOffsetMinutes
+    : null;
+  return {
+    ...rest,
+    ...(accountType !== undefined && CHAT_ACCOUNT_TYPES.includes(accountType) ? { accountType } : {}),
+    ...(knownBadges.length > 0 ? { badges: knownBadges } : {}),
+    ...(offset !== null ? { utcOffsetMinutes: offset } : {}),
+    ...(knownDesks.length > 0 ? { desks: knownDesks } : {}),
+  };
 }
 
 export function normalizeChatMessage(message: ChatMessage): ChatMessage {
   const normalized: ChatMessage = {
     ...message,
-    user: chatUserWithKnownAccountType(message.user),
+    user: normalizeChatUser(message.user),
     content: typeof message.content === "string" ? message.content : "",
     createdAt: normalizeTimestamp(message.createdAt),
     ...(message.editedAt
@@ -105,6 +128,11 @@ export function normalizeChatMessage(message: ChatMessage): ChatMessage {
   if (message.attachmentReview !== "pending" && message.attachmentReview !== "failed") {
     delete normalized.attachmentReview;
   }
+  if ("paneLink" in message) {
+    const paneLink = parseChatPaneLink(message.paneLink);
+    if (paneLink) normalized.paneLink = paneLink;
+    else delete normalized.paneLink;
+  }
   return normalized;
 }
 
@@ -171,6 +199,8 @@ export function normalizeChatChannel(
     ...channel,
     kind: channel.kind ?? fallbackKind,
     created_at: normalizeTimestamp(channel.created_at),
+    ...(channel.dmUser ? { dmUser: normalizeChatUser(channel.dmUser) } : {}),
+    ...(Array.isArray(channel.members) ? { members: channel.members.map(normalizeChatUser) } : {}),
   };
 }
 

package/src/api-client/organization-tickers.ts

@@ -0,0 +1,44 @@
+/** Names per request: one page of a list, such as a clinical trial search page's lead sponsors. */
+export const ORGANIZATION_TICKERS_BATCH_LIMIT = 50;
+
+/**
+ * What Gloom Cloud resolved an organization name to: the listing of the
+ * company the name belongs to, or why there is none. The match is the
+ * server's, from reviewed and exact aliases only; the app never matches a
+ * name to a ticker itself.
+ */
+export interface OrganizationTicker {
+  name: string;
+  /** Null when the name is unlinked, ambiguous, or resolved to a company without a listing. */
+  ticker: string | null;
+  exchange: string | null;
+  /** The company the name resolved to; null when unlinked. */
+  entityName: string | null;
+  resolution: "identifier" | "alias" | "unresolved";
+  /** Left unlinked because the name fits more than one company. */
+  ambiguous: boolean;
+}
+
+export interface OrganizationTickersResponse {
+  results: OrganizationTicker[];
+}
+
+function isResult(value: unknown): value is OrganizationTicker {
+  if (!value || typeof value !== "object") return false;
+  const row = value as Record<string, unknown>;
+  const text = (field: unknown) => field === null || typeof field === "string";
+  return typeof row.name === "string"
+    && text(row.ticker) && text(row.exchange) && text(row.entityName)
+    && (row.resolution === "identifier" || row.resolution === "alias" || row.resolution === "unresolved")
+    && typeof row.ambiguous === "boolean";
+}
+
+/** The answers in the order asked; throws when the server answered something else. */
+export function validateOrganizationTickers(payload: unknown, names: readonly string[]): OrganizationTicker[] {
+  const results = (payload as Partial<OrganizationTickersResponse> | null)?.results;
+  if (!Array.isArray(results) || results.length !== names.length || !results.every(isResult)
+    || results.some((result, index) => result.name !== names[index])) {
+    throw new Error("The server returned invalid organization tickers.");
+  }
+  return results;
+}

package/src/api-client/request.ts

@@ -410,12 +410,14 @@ export class CloudApiRequestTransport {
     // Cloud outage in the connections pane. Nor must the map's probe for geo
     // layers, which a server without them answers with 404, or a ticker
     // change lookup: a note beside a quote, never one of the refused market
-    // requests a lookup of many symbols waits out and retries.
+    // requests a lookup of many symbols waits out and retries. Nor the
+    // tickers beside a list of organization names, which say so in place.
     if (
       path.startsWith("/telemetry/")
       || path === "/assist/searches"
       || path === "/cloud/geo/layers"
       || path.startsWith("/market/ticker-changes?")
+      || path === "/market/organization-tickers"
     ) return request();
     return this.connectionHealth.track(
       GLOOM_CLOUD_HTTP_CONNECTION_ID,

package/src/api-client/types.ts

@@ -9,6 +9,7 @@ import type {
   TickerFinancials,
 } from "../types/financials";
 import type { SyncSettings, SyncSnapshot } from "../sync/types";
+import type { ChatPaneLink } from "./chat-pane-link";
 
 /**
  * What stands behind a chat account. `discord` is a person on the Gloom
@@ -20,6 +21,9 @@ export type ChatAccountType = "human" | "managed_llm" | "discord";
 /** Where a message was written. A message without one came from the app. */
 export type ChatMessageOrigin = "app" | "discord";
 
+/** A badge an account earns in chat: `team` for Gloom staff, `pro` with Pro access. */
+export type ChatUserBadge = "team" | "pro";
+
 export interface ChatUserSummary {
   id: string;
   /** A person, a managed assistant (Gloombot), or a Discord user bridged into public channels. */
@@ -32,6 +36,15 @@ export interface ChatUserSummary {
   profilePublic?: boolean;
   acceptUnknownDms?: boolean;
   portfolioAnalytics?: PublicPortfolioAnalytics | null;
+  /** Badges the account earns. A server that predates them, or a person with none, leaves this out. */
+  badges?: ChatUserBadge[];
+  /**
+   * The person's current offset from UTC in minutes, as their app last
+   * reported it: left out while they keep their local time hidden.
+   */
+  utcOffsetMinutes?: number;
+  /** The desks (equities, options, ...) the person chose to show; left out unless they did. */
+  desks?: string[];
 }
 
 /**
@@ -105,6 +118,8 @@ export interface ChatMessage {
    * message yet.
    */
   attachmentReview?: "pending" | "failed";
+  /** What the message opens in the terminal (a Gloom Wire story or calendar). Only the server sets it. */
+  paneLink?: ChatPaneLink;
   clientStatus?: "sending" | "failed";
   clientError?: string | null;
   /** The idempotency key a local send went out with, so a retry repeats it. */
@@ -208,6 +223,12 @@ export interface AccountProfile {
   acceptUnknownDms: boolean;
   chatEmailNotificationsEnabled: boolean;
   portfolioAnalytics?: PublicPortfolioAnalytics | null;
+  /** Chat shows your local time on your card. A server that predates the setting leaves it out. */
+  showLocalTime?: boolean;
+  /** The desks chat shows beside your name; empty shows none. */
+  chatDesks?: string[];
+  /** Your answer to "What do you trade?" at the first run: private, it pre-fills `chatDesks`. */
+  onboardingDesks?: string[];
   syncEnabled: boolean;
   weeklyRoundupEnabled: boolean;
   positionAlertsEnabled: boolean;
@@ -351,6 +372,9 @@ export type AccountProfileUpdate = Partial<{
   syncEnabled: boolean;
   weeklyRoundupEnabled: boolean;
   positionAlertsEnabled: boolean;
+  showLocalTime: boolean;
+  /** Null or empty shows no desks. */
+  chatDesks: string[] | null;
 }>;
 
 export interface CloudSyncSnapshotResponse {
@@ -1421,7 +1445,9 @@ export interface CloudHistoryCoverage {
   /** First bar date (YYYY-MM-DD) the source serves, such as a fund's inception. */
   firstAllowedBarDate?: string;
   inceptionDate?: string;
-  sourceUrl: string;
+  /** Why nothing earlier is served, such as "old-shekel quotes before 1992 are not served". */
+  note?: string;
+  sourceUrl?: string;
   firstBarDate: string | null;
   lastBarDate: string | null;
   barCount: number;