gloomberb 0.17.6 → 0.18.0

package/src/api-client/insider-signals.ts

@@ -1,11 +1,13 @@
 /**
- * Companies ranked by recent open-market insider buying, as
- * `GET /cloud/sec/insider-signals` returns them. Only Form 4 purchases (code
- * P) by officers, directors and 10% owners count. Dates are `YYYY-MM-DD`,
- * values USD.
+ * Companies ranked by recent open-market insider buying or selling, as
+ * `GET /cloud/sec/insider-signals` returns them. Buying counts Form 4
+ * purchases (code P), selling the sales (code S) an insider chose to make: a
+ * Rule 10b5-1 plan's, a sell-to-cover's, an option exercise's and an
+ * offering's are left out. Only officers, directors and 10% owners count.
+ * Dates are `YYYY-MM-DD`, values USD.
  */
 
-type InsiderSignalRole =
+export type InsiderSignalRole =
   | "CEO"
   | "CFO"
   | "COO"
@@ -15,13 +17,57 @@ type InsiderSignalRole =
   | "Director"
   | "10% owner";
 
-interface InsiderSignalBuyer {
+/** Purchases or sales. */
+export type InsiderSignalSide = "buy" | "sell";
+/** Whose trades a ranking reads: everyone, chief officers and other officers, directors, or 10% owners. */
+export type InsiderSignalRoleGroup = "all" | "officers" | "directors" | "owners";
+/** Market value: micro under $300M, small to $2B, mid to $10B, large above. */
+export type InsiderSignalCap = "micro" | "small" | "mid" | "large";
+
+/**
+ * One insider in a row: what they traded in the window. On the sell side
+ * `buys` and `lastBuy` are the days they sold and the last of them.
+ */
+export interface InsiderSignalBuyer {
   name: string;
   role: InsiderSignalRole;
   value: number;
-  /** Days the insider bought in the window. */
+  /** Days the insider traded in the window. */
   buys: number;
   lastBuy: string;
+  /** Left out by servers that predate selling. */
+  shares?: number;
+  /** The holding's change in the window, percent: positive bought, negative sold; null without balances. */
+  stakeChangePct?: number | null;
+  /** Opened a position: held nothing before, or a holding worth under $10K or under 1% of what was bought. */
+  newPosition?: boolean;
+  /** Sold every share and unit the forms report. */
+  exited?: boolean;
+  /**
+   * The insider's trade days in the 90 days ending on their last, the days
+   * before the window included: their nth buy (sale), 1 for a lone day. Null
+   * when they traded both ways. Left out by servers that predate it.
+   */
+  repeatBuys?: number | null;
+  /**
+   * Their largest day in the window against their usual size, to a tenth and
+   * at most 100 ("100x+"); null without enough history, or when they traded
+   * both ways. Left out by servers that predate it.
+   */
+  usualRatio?: number | null;
+  /** Bought and sold in the window: the row counts the net, on the side it falls. */
+  twoWay?: boolean;
+}
+
+/** One fact behind a row, structured, strongest first. */
+interface InsiderWhySignal {
+  kind: "cluster" | "repeat" | "usual" | "stake" | "new" | "exited" | "size" | "both";
+  /** cluster: insiders; repeat: the ordinal; usual: the multiple; stake: percent, negative sold; new, exited, both: 1; size: dollars. */
+  value: number;
+  /** A few characters: "3 insiders", "4th buy", "5x usual", "+56%", "6x stake", "NEW", "both ways". */
+  text: string;
+  /** The insider it is about; null for the company's (a cluster). */
+  insider: { name: string; role: InsiderSignalRole } | null;
 }
 
 export interface InsiderSignalRow {
@@ -32,9 +78,9 @@ export interface InsiderSignalRow {
   score: number;
   /** Why the company ranks, strongest first, in plain words. */
   reasons: string[];
-  /** Distinct insiders who bought in the window. */
+  /** Distinct insiders who traded in the window. */
   insiders: number;
-  /** Insider buy days in the window. */
+  /** Insider trade days in the window. */
   buys: number;
   value: number;
   shares: number;
@@ -47,14 +93,40 @@ export interface InsiderSignalRow {
     usualRatio: number | null;
     stakeIncreasePct: number | null;
     newPosition: boolean;
+    /** Left out by servers that predate selling. */
+    stakeChangePct?: number | null;
+    exited?: boolean;
   };
-  /** The biggest buyers, up to five. */
+  /** The reasons' facts, structured; left out by servers that predate them. */
+  whySignals?: InsiderWhySignal[];
+  /** The insiders who traded, largest first, up to ten. */
   buyers: InsiderSignalBuyer[];
+  /** Stored market value, USD; null when the server has none for it. */
+  marketCap?: number | null;
+}
+
+interface InsiderSignalsFilters {
+  role: InsiderSignalRoleGroup;
+  minValue: number;
+  cluster: boolean;
+  position: "new" | "exited" | null;
+  cap: InsiderSignalCap | null;
 }
 
 export interface InsiderSignalsPayload {
-  /** Days of buying each row covers, ending `through`. */
+  /**
+   * The company asked for (`ticker`): `rows` is its row alone, with every
+   * insider, whatever its size. Absent for the ranking, and from a server
+   * that predates the question, which answers the ranking instead.
+   */
+  ticker?: string;
+  /** Left out by servers that predate selling: buying. */
+  side?: InsiderSignalSide;
+  /** Days of trading each row covers, ending `through`. */
   window: number;
+  filters?: InsiderSignalsFilters;
+  /** Whether rows carry market values, so the cap filter can work. */
+  marketCaps?: "stored" | "unavailable";
   through: string;
   /** The newest filing day read. */
   asOf: string | null;
@@ -68,8 +140,20 @@ export interface InsiderSignalsPayload {
 }
 
 export interface CloudInsiderSignalsParams {
+  /** Buying unless told. */
+  side?: InsiderSignalSide;
   /** Days, 1 to 90; the server reads 30 when left out. */
   window?: number;
   /** Rows, 1 to 200; the server reads 50 when left out. */
   limit?: number;
+  role?: InsiderSignalRoleGroup;
+  /** USD the insiders traded in the window, at least. */
+  minValue?: number;
+  /** Only companies where two insiders or more traded within a span. */
+  cluster?: boolean;
+  /** "new" on the buy side, "exited" on the sell side. */
+  position?: "new" | "exited";
+  cap?: InsiderSignalCap;
+  /** One company instead of the ranking: its row, with every insider. */
+  ticker?: string;
 }

package/src/api-client/normalizers.ts

@@ -134,6 +134,7 @@ export function normalizeChatMessage(message: ChatMessage): ChatMessage {
     if (paneLink) normalized.paneLink = paneLink;
     else delete normalized.paneLink;
   }
+  if ((message.announcement as unknown) !== true) delete normalized.announcement;
   return normalized;
 }
 

package/src/api-client/paths.ts

@@ -246,6 +246,8 @@ export type CloudSecFilingsParams = {
   name?: string;
   limit?: number;
   offset?: number;
+  /** Only these forms, each with its amendment (`8-K` is also `8-K/A`). A server that predates the filter sends every form. */
+  forms?: readonly string[];
 };
 
 export type CloudSecFilingParams = {
@@ -361,6 +363,10 @@ export function cloudEarningsTranscriptPath(id: string): string {
   return `/cloud/transcripts/${encodeURIComponent(id)}`;
 }
 
+export function cloudEarningsCallAudioPath(id: string): string {
+  return `${cloudEarningsTranscriptPath(id)}/audio`;
+}
+
 /**
  * An issuer read's path: a US listing or a bare symbol keeps its US ticker
  * and sends nothing else; a listing abroad sends its bare symbol with its
@@ -429,10 +435,16 @@ export function cloudSecFilingsPath(params: CloudSecFilingsParams): string {
   });
   if (params.limit != null) search.set("limit", String(params.limit));
   if (params.offset != null) search.set("offset", String(params.offset));
+  if (params.forms?.length) search.set("form", params.forms.join(","));
   setListingAbroad(search, abroad);
   return appendQuery("/cloud/sec/filings", search);
 }
 
+/** A US-listed company's bank figures: SEC deposits and its lead bank's FDIC call report. */
+export function cloudBankFiguresPath(symbol: string): string {
+  return appendQuery("/cloud/bank-figures", new URLSearchParams({ symbol }));
+}
+
 /** Schedule 13D and 13G reports about the issuer behind `ticker`. */
 export function cloudSecBeneficialOwnersPath(params: CloudBeneficialOwnersParams): string {
   const abroad = listingAbroad(params.ticker, params.exchange, params.name);
@@ -445,11 +457,18 @@ export function cloudSecBeneficialOwnersPath(params: CloudBeneficialOwnersParams
   return appendQuery("/cloud/sec/beneficial-owners", search);
 }
 
-/** Companies ranked by recent open-market insider buying. */
+/** Companies ranked by recent open-market insider buying or selling. Defaults are left out of the query. */
 export function cloudSecInsiderSignalsPath(params: CloudInsiderSignalsParams = {}): string {
   const search = new URLSearchParams();
+  if (params.side === "sell") search.set("side", "sell");
   if (params.window != null) search.set("window", String(params.window));
   if (params.limit != null) search.set("limit", String(params.limit));
+  if (params.role && params.role !== "all") search.set("role", params.role);
+  if (params.minValue) search.set("minValue", String(params.minValue));
+  if (params.cluster) search.set("cluster", "true");
+  if (params.position) search.set("position", params.position);
+  if (params.cap) search.set("cap", params.cap);
+  if (params.ticker) search.set("ticker", params.ticker);
   return appendQuery("/cloud/sec/insider-signals", search);
 }
 

package/src/api-client/request.ts

@@ -1,3 +1,4 @@
+import { logFailure } from "../utils/log-failure";
 import { httpFetch, isHttpFetchStreaming } from "../utils/http-transport";
 import { withDeadline } from "../utils/async-deadline";
 import {
@@ -148,7 +149,7 @@ export async function putWithRevision<T, Current extends { revision: number }>(
     });
   } catch (error) {
     if (!(error instanceof ApiRequestError) || error.status !== 412) throw error;
-    const current = await revision.loadCurrent().catch(() => null);
+    const current = await revision.loadCurrent().catch(logFailure("cloud-request", "Current revision request failed", null));
     throw new revision.conflict(error.message, current, current?.revision ?? (revision.expected ?? 0) + 1);
   }
 }
@@ -269,7 +270,7 @@ export class CloudApiRequestTransport {
         });
         throwIfRequestAborted(options.signal);
         if (!response.ok) {
-          const text = await response.text().catch(() => "");
+          const text = await response.text().catch(logFailure("cloud-request", "Error response body read failed", ""));
           throw new ApiRequestError(
             parseApiErrorMessage(text),
             response.status,
@@ -411,12 +412,19 @@ export class CloudApiRequestTransport {
     // 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. Nor the
-    // tickers beside a list of organization names, which say so in place.
+    // tickers beside a list of organization names, which say so in place,
+    // or a 13F filer's EDGAR filing list, whose report says it went unchecked.
+    // Nor the batched searches and ticker changes a list of symbols starts
+    // with: a service without them answers 404, and whatever they leave
+    // unanswered is looked up one symbol at a time, which is tracked.
     if (
       path.startsWith("/telemetry/")
       || path === "/assist/searches"
       || path === "/cloud/geo/layers"
+      || path.startsWith("/cloud/sec/13f/filer?")
       || path.startsWith("/market/ticker-changes?")
+      || path === "/market/ticker-changes/batch"
+      || path === "/market/search/batch"
       || path === "/market/organization-tickers"
     ) return request();
     return this.connectionHealth.track(

package/src/api-client/research-activity.ts

@@ -1,3 +1,4 @@
+import { logFailure } from "../utils/log-failure";
 import { apiClient } from "./index";
 import { getCurrentPluginTarget } from "../plugins/current-target";
 import type { DesktopDeepLinkBridge } from "../types/desktop-deeplink";
@@ -99,6 +100,7 @@ function cleanUrlValue(value: unknown): string | undefined {
     new URL(cleaned);
     return cleaned;
   } catch {
+    // Intentional ignore: Malformed attribution URLs are excluded from the payload.
     return undefined;
   }
 }
@@ -122,7 +124,7 @@ export function readStoredAttribution(stored: string | null, now = Date.now()):
     const parsed: unknown = JSON.parse(stored ?? "{}");
     if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) saved = parsed as Record<string, unknown>;
   } catch {
-    /* Corrupt storage is the same as no storage. */
+    // Intentional ignore: Corrupt optional attribution is treated as absent.
   }
 
   const next: Record<string, string> = {};
@@ -170,6 +172,7 @@ export function carriesHandoff(href: string): boolean {
       FIRST_TOUCH_KEYS.some((key) => params.has(key))
     );
   } catch {
+    // Intentional ignore: Malformed links carry no usable attribution handoff.
     return false;
   }
 }
@@ -258,7 +261,7 @@ export function initializeBrowserResearchActivity(): void {
     stripHandoffParams(url);
     history.replaceState(history.state, "", url.href);
   } catch {
-    /* Private browsing must still work. */
+    // Intentional ignore: Private browsing may deny optional attribution storage.
   }
 }
 
@@ -275,7 +278,7 @@ export function initializeDesktopResearchActivity(storage: StorageLike = localSt
     anonymousId = stored && ANONYMOUS_ID.test(stored) ? stored : undefined;
     attribution = readStoredAttribution(storage.getItem(ATTRIBUTION_STORAGE_KEY));
   } catch {
-    /* A read-only profile still runs the app. */
+    // Intentional ignore: A read-only profile may deny optional attribution storage.
   }
 }
 
@@ -297,6 +300,7 @@ export function adoptDesktopHandoff(href: string, storage: StorageLike = localSt
     storage.setItem(ATTRIBUTION_STORAGE_KEY, JSON.stringify(attribution));
     return true;
   } catch {
+    // Intentional ignore: Optional attribution storage may be unavailable; the deep link still opens.
     return false;
   }
 }
@@ -406,9 +410,10 @@ export function recordResearchActivity(
       if (!wallEvent) return;
       const views = wallSessionViews();
       views.add(key);
-      try { sessionStorage.setItem(WALL_VIEWS_SESSION_KEY, JSON.stringify([...views])); } catch { /* Native sessions use the in-memory set. */ }
+      try { sessionStorage.setItem(WALL_VIEWS_SESSION_KEY, JSON.stringify([...views])); } catch { /* Intentional ignore: Native sessions retain wall views in the in-memory set. */ }
     })
-    .catch(() => {
+    .catch((error) => {
+      logFailure("cloud-telemetry", "Research activity request failed")(error);
       sent.delete(key);
     });
 }
@@ -432,7 +437,8 @@ export function recordResearchTabView(tabId: string, fromExternalPlugin: boolean
 export function identifyResearchUser(): void {
   try {
     recordResearchActivity("workspace_opened");
-  } catch {
+  } catch (error) {
+    logFailure("cloud-telemetry", "Research identity reporting failed")(error);
     /* Analytics never blocks sign-in. */
   }
 }
@@ -444,6 +450,7 @@ function webExperimentAttribution(): { experiments?: string } {
     const experiments = storedExperimentAssignments(localStorage);
     return experiments ? { experiments } : {};
   } catch {
+    // Intentional ignore: Unavailable optional storage contributes no experiment attribution.
     return {};
   }
 }
@@ -499,7 +506,7 @@ function wallExperimentContext(): WallExperimentContext {
   try {
     if (surface === "web") local = localStorage;
     if (surface === "web" || surface === "desktop") session = sessionStorage;
-  } catch { /* Native and private sessions keep their answer in memory. */ }
+  } catch { /* Intentional ignore: Native and private sessions keep experiment answers in memory. */ }
   return {
     surface,
     accountId: user?.id,
@@ -516,7 +523,7 @@ function wallSessionViews(): Set<string> {
   try {
     const saved: unknown = JSON.parse(sessionStorage.getItem(WALL_VIEWS_SESSION_KEY) ?? "[]");
     if (Array.isArray(saved)) return new Set(saved.filter((value): value is string => typeof value === "string"));
-  } catch { /* Native sessions use the in-memory set. */ }
+  } catch { /* Intentional ignore: Native sessions retain wall views in the in-memory set. */ }
   return new Set();
 }
 

package/src/api-client/socket.ts

@@ -1,3 +1,4 @@
+import { logFailure } from "../utils/log-failure";
 import type { TapeFeedEvent } from "./tape";
 import type {
   AuthUser,
@@ -188,7 +189,7 @@ export class CloudApiSocket {
     try {
       ws?.close();
     } catch {
-      // ignore closed sockets
+      // Intentional ignore: Closing an already closed socket needs no further cleanup.
     }
   }
 
@@ -312,7 +313,8 @@ export class CloudApiSocket {
     try {
       this.ws.send(JSON.stringify(payload));
       return true;
-    } catch {
+    } catch (error) {
+      logFailure("cloud-socket", "WebSocket frame send failed")(error);
       return false;
     }
   }
@@ -557,7 +559,8 @@ export class CloudApiSocket {
     let parsed: any;
     try {
       parsed = JSON.parse(raw);
-    } catch {
+    } catch (error) {
+      logFailure("cloud-socket", "WebSocket message decoding failed")(error);
       return;
     }
 

package/src/api-client/supply-chain-graph.ts

@@ -7,7 +7,7 @@ export interface GraphOptions {
   minPct: number; minConfidence: number; limit: number; ranking: "score" | "shortest"; asOf?: string;
 }
 export const DEFAULT_GRAPH_OPTIONS: GraphOptions = { depth: 2, direction: "both", roles: [], sources: [], tiers: [], minPct: 0, minConfidence: 0, limit: 50, ranking: "score" };
-export interface GraphEvidence extends Pick<SupplyRow, "claimType" | "corroboration" | "leadStatus" | "firstSeenAt" | "lastSeenAt" | "lastConfirmedAt" | "whyUnconfirmed" | "evidence" | "nativeAmount" | "nativeCurrency" | "nativeScale" | "entityScope" | "quoteGloss" | "sectionRef" | "sourceAttribution"> {
+export interface GraphEvidence extends Pick<SupplyRow, "claimType" | "corroboration" | "leadStatus" | "firstSeenAt" | "lastSeenAt" | "lastConfirmedAt" | "whyUnconfirmed" | "evidence" | "nativeAmount" | "nativeCurrency" | "nativeScale" | "entityScope" | "quoteGloss" | "sectionRef" | "sourceAttribution" | "periodMonths"> {
   /** Source trust tier, distinct from the graph evidence class in tier. */
   trustTier?: SupplyTier;
   id: string; fromEntity: string; toEntity: string; reportingEntity: string;
@@ -25,7 +25,7 @@ interface GraphLink {
 }
 export interface GraphPath {
   id: string; nodeIds: string[]; linkIds: string[]; hops: number; score: number; confidence: number;
-  exposure: { pct: number; basis: NonNullable<SupplyRow["pctBasis"]>; period: string; denominatorEntityId: string; estimated: true } | null;
+  exposure: { pct: number; basis: NonNullable<SupplyRow["pctBasis"]>; period: string; periodMonths?: number | null; denominatorEntityId: string; estimated: true } | null;
 }
 interface GraphReach { entityId: string; direction: "upstream" | "downstream"; hops: number; bestPath: GraphPath; shortestPath: GraphPath; }
 export interface GraphPayload {

package/src/api-client/supply-chain.ts

@@ -55,6 +55,8 @@ export interface SupplyRow {
   jurisdiction?: string | null;
   entityScope?: "entity" | "group" | "anonymous" | "aggregate" | null;
   period: string;
+  /** Months every figure on the row covers: 0 a balance at the period end, 3 a quarter, 12 a year. Null or absent when the source does not say or the figures differ in length. */
+  periodMonths?: number | null;
   fiscalYear: string | null;
   sourceKind: "xbrl" | "filing_text" | "call" | "news" | "web" | "import" | "press_release";
   form: string | null;
@@ -88,6 +90,12 @@ export interface SupplyChainPayload {
   says: SupplyRow[];
   names: SupplyRow[];
   counts: { says: Record<SupplyRole, number>; names: Record<SupplyRole, number> };
+  /**
+   * Shares from a period before the latest one their reporter disclosed on the
+   * same basis: dated, never current rows. Absent from older servers.
+   */
+  earlier?: { says: SupplyRow[]; names: SupplyRow[] };
+  earlierCounts?: { says: Record<SupplyRole, number>; names: Record<SupplyRole, number> };
   access: "full" | "preview";
   lockedRows: number;
   totalRows: number;

package/src/api-client/tape.ts

@@ -39,6 +39,18 @@ export interface TapeSnapshot {
   corrections: number;
   cancels: number;
   connected: boolean;
+  /**
+   * Present when a window was asked for (`from`/`to`): the span served, its
+   * end clipped to the feed cutoff, and whether a channel held more than its
+   * capacity there, so only the first of its prints are listed. Absent from a
+   * server that predates windows, which answers with the latest tape.
+   */
+  window?: TapeRange & { truncated: { trades: boolean; quotes: boolean } };
+}
+/** A span of the tape as ISO instants; `to` is exclusive. */
+export interface TapeRange {
+  from: string;
+  to: string;
 }
 export type TapeFeedEvent = { type: "data"; payload: TapeSnapshot }
   | { type: "reset" | "disconnected"; reason: string };

package/src/api-client/types.ts

@@ -120,6 +120,12 @@ export interface ChatMessage {
   attachmentReview?: "pending" | "failed";
   /** What the message opens in the terminal (a Gloom Wire story or calendar). Only the server sets it. */
   paneLink?: ChatPaneLink;
+  /**
+   * An announcement Gloom posted, drawn as one. Only the server sets it, and
+   * only on one that still stands: a retracted announcement is the removal
+   * placeholder without it.
+   */
+  announcement?: true;
   clientStatus?: "sending" | "failed";
   clientError?: string | null;
   /** The idempotency key a local send went out with, so a retry repeats it. */
@@ -611,9 +617,25 @@ export interface CloudCdsHistoryPointPayload {
   reported: number;
   /** The contract on the run that day, e.g. "2031-12-20". */
   maturity: string;
+  /** For a line quoted upfront: that day's level in points on the line's coupon. */
+  upfrontPts?: number;
+}
+
+/**
+ * Past 2,000bp a name is quoted in points upfront on its running coupon, the
+ * level and its moves alike; `spreadBp` and the bp moves stay beside them.
+ * Absent from servers before it, which read as `spread`.
+ */
+interface CloudCdsUpfrontQuote {
+  quote?: "spread" | "upfront";
+  /** The line's running coupon, bp. */
+  couponBp?: number | null;
+  upfrontPts?: number | null;
+  change1WPts?: number | null;
+  change1MPts?: number | null;
 }
 
-export interface CloudCdsHistoryResponse {
+export interface CloudCdsHistoryResponse extends CloudCdsUpfrontQuote {
   source: string;
   /** The matched reference entity, or null when nothing on the tape matched. */
   issuer: string | null;
@@ -621,14 +643,31 @@ export interface CloudCdsHistoryResponse {
   currency: string | null;
   asOf: string | null;
   points: CloudCdsHistoryPointPayload[];
+  /**
+   * The last point's move over a week and a month in bp, on one contract and
+   * chained through the contract before across a roll, as the index board's.
+   * Null without a comparable level, or once the level is more than 5 trading
+   * days behind the tape; absent from servers before them.
+   */
+  change1W?: number | null;
+  change1M?: number | null;
+  /**
+   * Why the line has no level in the month to its newest print, when one
+   * cause explains it: `upfront-side-unknown` when the prints carry an
+   * upfront without the side that paid it and nothing else places the level.
+   */
+  noLevelReason?: string | null;
 }
 
 /** An issuer's latest 5Y level: the last point of its history over the last month. */
-export interface CloudCdsLevelPayload {
+export interface CloudCdsLevelPayload extends CloudCdsUpfrontQuote {
   /** The reference entity as the history response names it. */
   issuer: string;
   spreadBp: number;
   date: string;
+  /** As the history response's moves for the same name. */
+  change1W?: number | null;
+  change1M?: number | null;
 }
 
 export interface CloudCdsLevelsResponse {
@@ -1099,6 +1138,8 @@ export interface CloudTranscriptTurnPayload {
   isQa: boolean;
   /** Offset into the recording; null when the company published the transcript as a document. */
   startSeconds: number | null;
+  /** Where each of `paragraphs` starts in the recording, in seconds; absent without timings or on older servers. */
+  paragraphStarts?: number[];
 }
 
 interface CloudTranscriptKeyFigurePayload {
@@ -1145,6 +1186,20 @@ export interface CloudEarningsTranscriptPayload {
   updatedAt: string | null;
 }
 
+/**
+ * A call's audio to play beside its transcript. `kind` names what it is; a
+ * stored recording is the only kind so far.
+ */
+export interface CloudEarningsCallAudioPayload {
+  kind: "recording";
+  /** A signed address that plays until `expiresAt`, seeking included. */
+  url: string;
+  expiresAt: string;
+  durationSeconds: number | null;
+  bytes?: number;
+  contentType?: string;
+}
+
 export type CloudSearchDocType = "transcript" | "news" | "filing";
 
 export type CloudSearchSort = "relevance" | "newest" | "oldest";
@@ -1263,10 +1318,14 @@ interface CloudSecFilingPayload {
   primaryDocument?: string;
   primaryDocDescription?: string;
   items?: string;
+  /** SEC's period of report, YYYY-MM-DD: a 10-Q's or 10-K's balance-sheet date. Absent from older servers. */
+  reportDate?: string;
   cik: string;
   companyName?: string;
   filingUrl: string;
   primaryDocumentUrl?: string;
+  /** The filing's SEC file number for this company, empty when it has none. Absent from older servers. */
+  fileNumber?: string;
 }
 
 interface CloudSecDocumentPayload {
@@ -1488,6 +1547,11 @@ export interface CloudMarketResponse<T> {
   session?: unknown;
   /** "1day" when daily bars answer an intraday range: the listing has no intraday bars. */
   servedResolution?: unknown;
+  /**
+   * Untrusted: daily sessions the bars leave out and why, as
+   * `[{ date: "2020-04-20", reason: "non-positive-close" }]`. Validated by the history adapter.
+   */
+  omittedSessions?: unknown;
   /** Untrusted until the history adapter validates its boundary dates. */
   coverage?: CloudHistoryCoverage;
   providerMeta?: {

package/src/api-client/upgrade-experiment.ts

@@ -1,3 +1,4 @@
+import { logFailure } from "../utils/log-failure";
 import type { ExperimentAnswer, StorageLike } from "./web-experiments";
 
 /**
@@ -36,11 +37,11 @@ function isVariant(value: unknown): value is UpgradePersonalizedVariant {
 }
 
 function read(storage: StorageLike | undefined, key: string): string | null {
-  try { return storage?.getItem(key) ?? null; } catch { return null; }
+  try { return storage?.getItem(key) ?? null; } catch { /* Intentional ignore: Private browsing may deny optional experiment storage. */ return null; }
 }
 
 function write(storage: StorageLike | undefined, key: string, value: string): void {
-  try { storage?.setItem(key, value); } catch { /* Storage is optional in private browsing. */ }
+  try { storage?.setItem(key, value); } catch { /* Intentional ignore: Private browsing may deny optional experiment storage. */ }
 }
 
 /**
@@ -77,7 +78,7 @@ export function createUpgradeExperimentSession() {
       if (inFlight) return inFlight;
       const request = (async () => {
         let answer: ExperimentAnswer;
-        try { answer = await ask(); } catch { return null; }
+        try { answer = await ask(); } catch (error) { logFailure("cloud-experiments", "Experiment exposure request failed")(error); return null; }
         const variant = answer.accepted && isVariant(answer.variant) ? answer.variant : null;
         answers.set(identity, variant);
         write(context.session, `${SESSION_PREFIX}${identity}`, variant ?? "excluded");

package/src/api-client/wall-experiments.ts

@@ -1,3 +1,4 @@
+import { logFailure } from "../utils/log-failure";
 import { EXPERIMENTS_STORAGE_KEY, storedExperimentAssignments, type ExperimentAnswer, type StorageLike } from "./web-experiments";
 
 export type WallExperiment = "wall_teaser" | "wall_teaser_signin";
@@ -25,11 +26,11 @@ function unit(context: WallExperimentContext, experiment: WallExperiment): strin
 }
 
 function read(storage: StorageLike | undefined, key: string): string | null {
-  try { return storage?.getItem(key) ?? null; } catch { return null; }
+  try { return storage?.getItem(key) ?? null; } catch { /* Intentional ignore: Private browsing may deny optional experiment storage. */ return null; }
 }
 
 function write(storage: StorageLike | undefined, key: string, value: string): void {
-  try { storage?.setItem(key, value); } catch { /* Storage is optional in private browsing. */ }
+  try { storage?.setItem(key, value); } catch { /* Intentional ignore: Private browsing may deny optional experiment storage. */ }
 }
 
 function isVariant(value: unknown): value is WallTeaserVariant {
@@ -77,7 +78,8 @@ export function createWallExperimentSession(experiment: WallExperiment = "wall_t
 
       const request = (async () => {
         let answer: ExperimentAnswer;
-        try { answer = await ask(storedVariant(context.local, experiment)); } catch {
+        try { answer = await ask(storedVariant(context.local, experiment)); } catch (error) {
+          logFailure("cloud-experiments", "Experiment exposure request failed")(error);
           // An older API (422), offline connection or timeout is not an exposure.
           return null;
         }

package/src/api-client/wall-summary.ts

@@ -1,3 +1,4 @@
+import { logFailure } from "../utils/log-failure";
 import { withDeadline } from "../utils/async-deadline";
 import { canonicalExchange } from "../utils/exchanges";
 import { CloudApiRequestTransport } from "./request";
@@ -43,7 +44,8 @@ export async function getWallSummary(wall: string, symbol: string, exchange?: st
       signal: controller.signal,
     }), 3_000, "Wall summary request timed out", (error) => controller.abort(error));
     return parseWallSummary(result);
-  } catch {
+  } catch (error) {
+    logFailure("cloud-wall-summary", "Wall summary request failed")(error);
     return null;
   }
 }