gloomberb 0.18.2 → 0.18.4

package/src/time-series/types.ts

@@ -1,4 +1,4 @@
-import type { ChartResolution, TimeRange } from "./range";
+import type { ChartResolution, CustomChartResolution, TimeRange } from "./range";
 import type { ChartResolutionSupport, ManualChartResolution } from "./resolution";
 import type { InstrumentRef } from "../market-data/request-types";
 import type { SeriesAttribution } from "../series/types";
@@ -69,7 +69,20 @@ export type ChartStudyKind =
   | "spread"
   | "correlation"
   /** A weighted sum of any number of series over a divisor: `(2*42*RB=F + 42*HO=F - 3*CL=F)/3`. */
-  | "formula";
+  | "formula"
+  /**
+   * A leveraged or inverse fund's objective drawn from its index fund: `factor`
+   * times the index fund's return each session, compounded (3× daily QQQ beside
+   * TQQQ). Inputs: the index fund.
+   */
+  | "leverage"
+  /**
+   * How far a leveraged fund falls short of its objective, in percentage
+   * points: the fund against the `factor`× daily line, and that line against
+   * `factor` times the index fund's return over the period. Inputs: the fund,
+   * then the index fund.
+   */
+  | "leverage-decay";
 
 export interface ChartStudySpec {
   id: string;
@@ -113,6 +126,13 @@ export interface TimeSeriesPoint {
   date: Date;
   observedAt: Date;
   availableAt?: Date;
+  /**
+   * The day the figure was released (`2026-10-20`), when its source says so for
+   * this point alone: FRED's newest observation from Gloom Cloud. The report
+   * line reads it; unlike `availableAt`, it never moves where the point is
+   * drawn or aligned, so the newest figure stays at its period like the rest.
+   */
+  releasedOn?: string;
   value: number | null;
   /** Original primary scalar before any presentation transform, including missing values. */
   rawValue?: number | null;
@@ -182,6 +202,11 @@ export interface ResolvedSeries {
   unreportedPeriod?: "quarterly";
   /** Acquired market-history cadence; null is explicitly unknown, undefined is legacy or nonmarket. */
   historyResolution?: ManualChartResolution | null;
+  /**
+   * The bar size the points were built in from `historyResolution` bars
+   * (`4h` from `1h`, `2d` from `1d`). Absent when the points are the source's own bars.
+   */
+  barSize?: CustomChartResolution;
   /**
    * When known, the first bar this listing has at `historyResolution`: the
    * source keeps nothing older, so the chart stops there instead of asking.
@@ -290,4 +315,6 @@ export interface ChartResolutionResult {
   viewport?: { start: Date; end: Date };
   /** Bar resolution the loaded market history was fetched at. */
   resolution?: ManualChartResolution;
+  /** The bar size the market series were built in from `resolution` bars, when the source does not serve it. */
+  barSize?: CustomChartResolution;
 }

package/src/time-series/use-chart-resolution.ts

@@ -1,14 +1,13 @@
 import { logFailure } from "../utils/log-failure";
 import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
+import { resolveChartSpecData } from "./resolve";
 import {
   ChartResolveCache,
-  chartSeedResolution,
-  reconcileChartTail,
-  resolveChartSpecData,
-  seedChartResolutionResult,
   type ChartResolveOptions,
   type ChartResolveSources,
-} from "./resolve";
+} from "./resolve-context";
+import { chartSeedResolution, seedChartResolutionResult } from "./chart-seed";
+import { reconcileChartTail } from "./tail-reconcile";
 import type { ChartResolutionResult, ChartSpec } from "./types";
 import {
   chartQuoteOverrideKeyForSource,

package/src/types/broker.ts

@@ -69,6 +69,11 @@ export interface BrokerConfigField {
 export interface BrokerConnectionStatus {
   state: "disconnected" | "connecting" | "connected" | "error";
   message?: string;
+  /**
+   * With `error`: only a new sign-in, to Gloom or the broker, gets the profile
+   * going again, so Brokers says "Sign-in needed" rather than "Error".
+   */
+  needsSignIn?: boolean;
   mode?: string;
   /**
    * Timeliness of the quotes this session streams, when the broker knows it.
@@ -124,6 +129,11 @@ export interface BrokerAdapter {
    * profile). Hosts that honor it export `LOCAL_BROKER_MARKET_DATA` from `gloomberb/broker`.
    */
   readonly localMarketData?: boolean;
+  /**
+   * `getQuote` answers the order ticket only, so the market data router never asks this broker:
+   * for a broker whose quotes count against a small request allowance (SnapTrade, signed in).
+   */
+  readonly ticketQuotesOnly?: boolean;
   validate(instance: BrokerInstanceConfig): Promise<boolean>;
   importPositions(instance: BrokerInstanceConfig): Promise<BrokerPosition[]>;
   importPortfolioSnapshot?(instance: BrokerInstanceConfig): Promise<{ accounts: BrokerAccount[]; positions: BrokerPosition[] }>;

package/src/types/config.ts

@@ -272,6 +272,13 @@ export interface RecentCommand {
   arg?: string;
 }
 
+/** What a launch's plugin seed could not install. */
+export interface PluginSeedFailure {
+  /** Extracted plugin ids, sorted. */
+  plugins: string[];
+  gitMissing: boolean;
+}
+
 export interface AppConfig {
   dataDir: string;
   configVersion: number;
@@ -291,6 +298,13 @@ export interface AppConfig {
    * not fought with.
    */
   seededPlugins?: string[];
+  /**
+   * The extracted plugins the last launch's seed could not install, and
+   * whether git was missing then. Absent until a seed fails, and again once
+   * one installs everything. `doctor` fails on it, and the launch notice that
+   * Gloom tries again is said once per failure.
+   */
+  pluginSeedFailure?: PluginSeedFailure;
   /**
    * Manual portfolios have taken the one currency their positions share. Runs
    * once per install, so later holdings never move a portfolio's currency.

package/src/types/data-provider.ts

@@ -2,6 +2,7 @@ import type { ExchangeRateSnapshot } from "./exchange-rate";
 import type {
   AnalystResearchData,
   CorporateActionsData,
+  EarningsDateStatus,
   EarningsEpsBasis,
   Quote,
   QuoteMetadata,
@@ -16,6 +17,7 @@ import type { BrokerContractRef, InstrumentSearchResult } from "./instrument";
 import type { CachePolicyMap } from "./persistence";
 import type { CachedQueryHandle } from "../data/cached-query";
 import type { TickerChanges } from "./ticker-changes";
+import type { IssuerListings } from "./issuer-listings";
 
 export type CachedAssetMethod = "getExchangeRate" | "getHolders" | "getAnalystResearch" | "getCorporateActions"
   | "getOptionsChain" | "getSecFilings" | "getSecFilingDocuments" | "getSecFilingContent" | "getArticleSummary";
@@ -52,6 +54,13 @@ export interface SecFilingItem {
    * does not say (an older server).
    */
   fileNumber?: string;
+  /**
+   * In a fund's list from a trust that runs several funds: whether EDGAR
+   * lists the filing under the fund's own series. Absent when the source does
+   * not say (another registrant, an older server, a filing older than the
+   * series list reaches).
+   */
+  fundSeries?: boolean;
 }
 
 export interface SecFilingDocument {
@@ -88,6 +97,12 @@ export interface EarningsEvent {
   earningsDate: Date;
   earningsCallDate?: Date | null;
   isDateEstimate?: boolean | null;
+  /**
+   * The report's status as Gloom Cloud holds it: reported once the report is
+   * out, before the calendar has its actual. Absent from servers that do not
+   * say; `isDateEstimate` and `epsActual` tell the rest.
+   */
+  dateStatus?: EarningsDateStatus | null;
   estimateBasis?: Partial<Record<EarningsEstimateField, EarningsEstimateBasis>>;
   epsEstimate: number | null;
   epsLow?: number | null;
@@ -252,6 +267,11 @@ export interface AssetDataProvider {
    * answer for is left out; null when the source cannot answer a batch at all.
    */
   getTickerChangesBatch?(symbols: string[], options?: { signal?: AbortSignal }): Promise<Map<string, TickerChanges | null> | null>;
+  /**
+   * Every listing of the company a listing belongs to (RCI and RCI.B:TSX are
+   * Rogers). Null when the source does not hold the company.
+   */
+  getIssuerListings?(symbol: string, exchange?: string, options?: { signal?: AbortSignal }): Promise<IssuerListings | null>;
   /**
    * Several searches in a few requests, each answered with the rows `search`
    * gives it from this source (up to `limit`), by query as asked. A query the

package/src/types/exchange-rate.ts

@@ -1,3 +1,5 @@
+import type { QuoteIntradayBar } from "./financials";
+
 /** Quote currency units per one base-currency unit; conversion rates use USD. */
 export interface ExchangeRateSnapshot {
   fromCurrency: string;
@@ -10,4 +12,8 @@ export interface ExchangeRateSnapshot {
   staleAt?: string;
   stale: boolean;
   delayMinutes?: number;
+  /** The rate is the close of this intraday bar of the pair's, its print having stopped behind it; asOf is the bar's end. */
+  intradayBar?: QuoteIntradayBar;
+  /** Why a stale rate stands, in Gloom Cloud's words. */
+  staleReason?: string;
 }

package/src/types/financials.ts

@@ -1,3 +1,4 @@
+import type { PerpBoardRow } from "../api-client/perps";
 import type { PriceBasis } from "./instrument";
 
 export type MarketState = "PRE" | "REGULAR" | "POST" | "PREPRE" | "POSTPOST" | "CLOSED";
@@ -72,12 +73,28 @@ export interface QuoteMetadata {
  */
 export type ShareBasis = "depositary_receipt" | "ordinary";
 
+/**
+ * A depositary receipt and the listings of the ordinary shares it represents,
+ * as Gloom Cloud serves it on both sides' records: GGAL with ratio 10 and
+ * GGAL.BA, on GGAL's quote and on GGAL.BA's alike.
+ */
+export interface DepositaryPair {
+  /** The receipt's US symbol. */
+  receipt: string;
+  /** Ordinary shares one receipt represents. */
+  ratio: number;
+  /** Listings of the ordinary shares (GGAL.BA), the home line first. */
+  ordinary: string[];
+}
+
 /** How a depositary receipt relates to the ordinary shares, as Gloom Cloud states it. */
 interface DepositaryReceiptFacts {
   /** Whether the listing is a depositary receipt; absent when unknown. */
   isDepositaryReceipt?: boolean;
   /** Ordinary shares per receipt, on a receipt's own records. */
   adrRatio?: number;
+  /** The receipt and its home lines, on the receipt's records and each home line's. */
+  depositaryPair?: DepositaryPair;
 }
 
 export interface Quote extends DepositaryReceiptFacts {
@@ -121,6 +138,14 @@ export interface Quote extends DepositaryReceiptFacts {
   receivedAt?: number; // local receipt timestamp ms for streamed/display freshness
   delivery?: QuoteDelivery;
   stale?: boolean;
+  /**
+   * The price is the close of this intraday bar of a currency pair's, not a
+   * print: Gloom Cloud took the bar because the pair's print had stopped
+   * behind it. lastUpdated is the bar's end.
+   */
+  intradayBar?: QuoteIntradayBar;
+  /** Why a stale currency pair's price stands, in Gloom Cloud's words: its bars have nothing newer, or could not be read in time. */
+  staleReason?: string;
   /** The listing no longer trades: the price is its last trade (ListingDelisting). */
   delisting?: ListingDelisting;
   exchangeName?: string;
@@ -181,6 +206,18 @@ export interface Quote extends DepositaryReceiptFacts {
   provenance?: QuoteProvenance;
   /** Freshness class for the quote data. Provider identity lives in providerId/provenance. */
   dataSource?: QuoteDataSource;
+  /**
+   * A perpetual contract's whole market row as of this quote (funding, open
+   * interest, premium), so every view of the contract reads the figures that
+   * came with its price, streamed or fetched.
+   */
+  perpetual?: PerpBoardRow;
+}
+
+/** A bar a quote's price is the close of: its start (epoch ms) and its length in minutes. */
+export interface QuoteIntradayBar {
+  start: number;
+  minutes: number;
 }
 
 export interface QuoteContribution extends Quote {
@@ -195,7 +232,7 @@ export interface TtmConversion {
   from: string;
   /** Units of `financialCurrency` per unit of `from` for revenue, income and cash flow; absent when not measured. */
   rate?: number;
-  /** YYYY-MM-DD the converted figures were fetched. */
+  /** YYYY-MM-DD the converted figures were fetched; once the app converts them again at its own rate (ttmAtAppRate), the ISO time of that rate. */
   asOf?: string;
   /** EPS is converted at the rate of each report date, so a P/E on it divides a spot price by EPS at older rates. */
   eps?: "report_date";
@@ -205,20 +242,28 @@ export interface TtmConversion {
  * How a served enterprise value ties to market cap + total debt - cash from the latest balance sheet served beside it.
  * `matches` within 5%; `differs` beyond it (or beyond 2% on the other side of the market cap from net debt), within
  * 0.7x to 1.5x, shown labelled as the provider's; `withdrawn` outside that band, with no EV or EV/revenue; `unchecked`
- * without a recent balance sheet carrying both lines.
+ * without a recent balance sheet carrying both lines. `computed`: an insurer's or a holding company's EV, which is
+ * `computed` itself, its investment book kept in (`investmentsKept`). `not-meaningful`: the EV comes out at or below
+ * zero, served as no EV or EV/revenue, with `reason`; shown N/M.
  */
 export interface EnterpriseValueCheck {
-  status: "matches" | "differs" | "withdrawn" | "unchecked";
-  /** The provider's enterprise value, served as `enterpriseValue` unless withdrawn. */
-  source: number;
-  currency: string;
-  marketCap: number;
+  status: "matches" | "differs" | "withdrawn" | "unchecked" | "computed" | "not-meaningful";
+  /** The provider's enterprise value, served as `enterpriseValue` unless withdrawn, computed or not meaningful; absent when it served none. */
+  source?: number;
+  /** The currency of the EV and the market cap. Absent, with `marketCap`, only on a not-meaningful source EV the block names no currency for. */
+  currency?: string;
+  /** The market cap the EV is measured on; absent only on a not-meaningful source EV served without one. */
+  marketCap?: number;
   totalDebt?: number;
   cash?: number;
   /** YYYY-MM-DD of the balance sheet the debt and cash come from. */
   balanceSheetDate?: string;
   /** marketCap + totalDebt - cash. */
   computed?: number;
+  /** `cash` is cash and equivalents alone: an insurer's or a holding company's investments stay in its EV. */
+  investmentsKept?: true;
+  /** Why the EV is not meaningful (`not-meaningful`). */
+  reason?: string;
 }
 
 /** How a trailing P/E converts the EPS it divides by, when that EPS is in another currency than the price. */
@@ -229,6 +274,23 @@ export interface TrailingPEConversion {
   rate: number;
 }
 
+/** How a share count and market cap were put on the basis after a split. */
+export interface SplitShareBasis {
+  /** The split's ex-date, YYYY-MM-DD. */
+  exDate: string;
+  /** What a price from before the split is multiplied by: 15 for a 1-for-15 reverse split, 0.1 for a 10-for-1 split. */
+  priceFactor: number;
+  /**
+   * `filing`: the count a filing reported as of `reportedAsOf`, moved by the split, the cap that count times the price.
+   * `provider_cap`: the provider's cap, its share count (`reportedShares`) being from before the split.
+   */
+  method: "filing" | "provider_cap";
+  reportedShares: number;
+  reportedAsOf?: string;
+  /** The provider's market cap the shown one replaced. */
+  providerMarketCap?: number;
+}
+
 export interface Fundamentals extends DepositaryReceiptFacts {
   /** Every share count here is on this basis, the basis of the listing's price and market cap; absent when unproven. */
   shareBasis?: ShareBasis;
@@ -284,8 +346,14 @@ export interface Fundamentals extends DepositaryReceiptFacts {
   return3Y?: number;
   lastQuarterGrowth?: number;
   sharesOutstanding?: number;
+  /** Set when a recent split put `sharesOutstanding` and `marketCap` on the basis the listing trades on. */
+  splitShareBasis?: SplitShareBasis;
+  /** YYYY-MM-DD `sharesOutstanding` was counted, when it is a 10-K or 10-Q cover count; a source's own count is undated. */
+  sharesOutstandingAsOf?: string;
   /** Free float: shares outstanding less insider and strategic holdings, never above `sharesOutstanding`. */
   floatShares?: number;
+  /** YYYY-MM-DD `floatShares` was counted, when it is a dated count itself (held at a cover count); a source's own float is undated. */
+  floatSharesAsOf?: string;
   beta?: number;
   /** Shares short at the latest FINRA settlement, the one `SI` and `SIW` show; dated by `shortInterestDate`. */
   sharesShort?: number;
@@ -308,11 +376,15 @@ export interface HolderRecord {
   providerId?: string;
   ownerType: HolderOwnerType;
   name: string;
+  /** The 13F filer's CIK, on a row from the SEC 13F holder index. */
+  cik?: string;
   reportDate?: string;
   shares?: number;
   value?: number;
+  /** The stake as a fraction of the shares outstanding: 0.0519 is 5.19%. */
   percentHeld?: number;
   changeShares?: number;
+  /** The quarter's change as a fraction of the prior position: 1.086 is +108.6%, -0.6 is -60%. */
   changePercent?: number;
   /** Set when the position's filing ties it to the receipts or to the ordinary shares. */
   shareBasis?: ShareBasis;
@@ -482,6 +554,12 @@ export interface CorporateActionsData {
 
 export interface CompanyProfile {
   description?: string;
+  /**
+   * Who published the description and where, when it is quoted from a
+   * document rather than the data provider's own text: a fund's issuer page,
+   * or the key facts its exchange publishes.
+   */
+  descriptionSource?: { publisher: string; url: string };
   sector?: string;
   industry?: string;
   employees?: number;
@@ -522,6 +600,18 @@ export interface IncomeStatementSource {
  */
 export type StatementGapField = IncomeStatementField | "totalRevenue" | "operatingRevenue" | "pretaxIncome" | "taxProvision";
 
+/** Lines Gloom Cloud fills from a listing's exchange for a year the statements source does not have yet. */
+export type StatementFillField = "totalRevenue" | "netIncome" | "totalAssets" | "totalLiabilities";
+
+/** Where a row's filled lines came from: the exchange's figures, its page, and when they were read. */
+export interface StatementFill {
+  source: "asx";
+  page: string;
+  retrievedAt: string;
+  /** The lines taken from the exchange; the row's other figures are the statements source's. */
+  fields: StatementFillField[];
+}
+
 /** Per-share earnings lines that can be declared unavailable. */
 export type EarningsField = "basicEps" | "eps";
 
@@ -646,6 +736,8 @@ export interface FinancialStatement {
   fieldSources?: Partial<Record<IncomeStatementField, IncomeStatementSource>>;
   /** Lines unavailable for this period; another source or income basis must not fill them. */
   unavailableFields?: StatementGapField[];
+  /** Lines filled from the listing's exchange for a year the statements source lacks. */
+  filledFrom?: StatementFill;
   // Income Statement
   totalRevenue?: number;
   costOfRevenue?: number;
@@ -812,6 +904,11 @@ export interface PricePoint {
   low?: number;
   close: number;
   volume?: number;
+  /**
+   * The trades of one venue alone, when the market's volume for the bar is unavailable: never its volume, so no sum
+   * or comparison with a day's count takes it.
+   */
+  venueVolume?: { venue: string; volume: number };
   /** The bar's period had not ended when it was served: its close is the latest price, and it may have no volume yet. */
   partial?: boolean;
   /** The bar's prices were rebuilt from shorter bars where the source left it empty or too coarse. */

package/src/types/headless.ts

@@ -67,8 +67,22 @@ export interface HeadlessPaneOptionDef {
    * own key, or `shotState`.
    */
   shot?: { reportOnly: string };
+  /**
+   * Options this one stands in for (`--from` for `--range`): typed together
+   * they are refused, since only one is read. The other's default does not
+   * count.
+   */
+  replaces?: readonly string[];
   /** The value's name in the catalog's flag, `--expiration <date|unix>`; the type when absent. */
   placeholder?: string;
+  /**
+   * How many words one value is, for a value typed as a pair on the command
+   * line (`--fx-shift TRY -20`): `fn` and `shot` read the words after the flag
+   * into it. A word that ends with a comma starts another value of the list
+   * (`--fx-shift TRY -20, EUR 5`), and so does the flag typed again. One when
+   * absent.
+   */
+  valueWords?: number;
   /** The option in use as typed after the function, such as `--expiration 2028-01-21`; the catalog shows it as an example. */
   example?: string;
   /** The example runs without the function's optional argument, as an option that works only then does (`fn INS --side sell`). */
@@ -103,6 +117,8 @@ export interface HeadlessPaneContext {
   /** Effective instance settings, after template creation and option normalization. */
   settings?: Record<string, unknown>;
   capabilities?: CapabilityInvoker;
+  /** The catalog's name for the series charted as an expression (`FRED:DFII10`); undefined for one it does not list. */
+  catalogSeriesName?: (expression: string) => string | undefined;
   /** Locally registered broker adapters. Reports may read account data; they never submit orders. */
   resolveBroker?: (brokerType: string) => import("./broker").BrokerAdapter | null;
   /** Read one local portfolio without passing holdings through a remote endpoint. */
@@ -124,6 +140,11 @@ export interface HeadlessPaneContext {
    * that listing instead (`BDI:TSX`), for the retry each listing offers.
    */
   resolveListing?: (symbol: string, argumentWith: (key: string) => string) => Promise<{ symbol: string; exchange?: string; name?: string } | null>;
+  /**
+   * What a plugin keeps on this device only (its `ctx.resume` state, never
+   * synced), such as ALRT's log of the alerts the app fired; null when none.
+   */
+  readDeviceState?: <T = unknown>(pluginId: string, key: string) => T | null;
 }
 
 export type HeadlessPaneRow = Record<string, unknown>;
@@ -141,18 +162,25 @@ export interface HeadlessPaneColumn {
   textHeader?: string;
   align?: "left" | "right" | "center";
   width?: number;
-  /** False keeps the column whole when the text table is fitted to a narrow width, so a time or an id is never cut. */
+  /**
+   * A narrow text table never cuts a cell by default: text wraps in its cell
+   * and columns move under their rows. False keeps the column on one line;
+   * true lets the table cut it, for free text that names nothing (a
+   * description), down to `minWidth`.
+   */
   shrink?: boolean;
-  /** The narrowest a text column is cut to in a narrow text table, so it never shrinks to a stub that reads like another row's. */
+  /** The narrowest a text column wraps to, or a `shrink: true` column is cut to, in a narrow text table. */
   minWidth?: number;
   /**
-   * When the text table cannot fit a narrow width even with its text
-   * shortened, columns move to lines under their row: a higher priority moves
-   * sooner, equal ones go rightmost first. The first column stays.
+   * When the text table does not fit a narrow width, columns move to lines
+   * under their row, each value whole: a higher priority moves sooner, then
+   * long text, then rightmost first. The first column stays.
    */
   stackPriority?: number;
   /** Once moved under the rows, only the first `stackRows` rows print the column; 0 leaves it out of a narrow table. */
   stackRows?: number;
+  /** The text table leaves the column out when fitted to fewer terminal columns than this; exports and piped output keep it. */
+  minTableWidth?: number;
   description?: string;
   format?: (value: unknown, row: HeadlessPaneRow) => string;
   /** What the text report prints when it can say more than an export should (a unit word beside a number); CSV and NDJSON keep `format`. */
@@ -161,9 +189,13 @@ export interface HeadlessPaneColumn {
    * The row field naming the unit of this column's number, for a column whose
    * rows are quoted in different units (CDX spreads in `bp`, prices in
    * `price`). Exports write the bare number and that unit: in the header when
-   * every row shares it, otherwise in a `<header> unit` column.
+   * every row shares it, otherwise in a `<header> unit` column. A column whose
+   * unit is the row's own (`rowUnitKey`) exports the bare number under its own
+   * header, the row's `currency_or_unit` naming the unit.
    */
   unitKey?: string;
+  /** With `unitKey`: always a `<header> unit` column, so the header is the same whichever rows loaded. */
+  unitColumn?: boolean;
   /**
    * The text report prints the value on its own lines under the row instead
    * of in a column, for a footnote that belongs to that row; an empty value
@@ -242,6 +274,19 @@ export interface HeadlessPaneFreshness {
    * so it names that month.
    */
   periodicity?: "monthly" | "quarterly" | "semiannual" | "annual";
+  /**
+   * How often the oldest observation publishes, when it is dated by its period
+   * and the newest is not (a monthly statistic charted beside daily closes):
+   * the report names its period, `Fri 23 Oct 2026 (oldest Sep 2026)`.
+   */
+  oldestPeriodicity?: "monthly" | "quarterly" | "semiannual" | "annual" | null;
+  /**
+   * When the newest observation was released, for figures dated by the period
+   * they cover (a monthly statistic's 1 Sep): a date, or the time when the
+   * publisher states it. The report is then as of that release and names both,
+   * `Sep 2026, released Tue 20 Oct`; its age and staleness stay the period's.
+   */
+  releasedOn?: string | number | Date | null;
   /**
    * The newest row is a weekly or monthly bar whose period had not ended when
    * it was served (October's bar on 16 Oct), and the last day it covers so
@@ -313,6 +358,14 @@ export interface HeadlessPaneFreshness {
   sources?: Array<{ source: string; asOf: string | number | Date }>;
   /** Say how old the oldest observation is (`oldest 4 min`): rows polled apart from one source. */
   oldestAge?: boolean;
+  /**
+   * Say how old the data is, the newest observation's time and `oldest 4 min`, and no more: no status word.
+   * For rows priced apart from a snapshot refreshed on a schedule (CRYP's board), where `live` would call prices
+   * that are minutes old real-time and `delayed` would call a snapshot renewed every few seconds held back. A row
+   * that states its own feed (`dataSource`, `delayMinutes`) still says it, and so does a declared `status`.
+   * Says how old the oldest observation is, as `oldestAge` does.
+   */
+  ageOnly?: boolean;
   /**
    * Rows quoted on several markets (a US line beside Xetra and Paris ones)
    * date each market's session in the status line, `US, XETRA and EPA Tue 13
@@ -332,12 +385,23 @@ export interface HeadlessPaneFreshness {
   asOfLabel?: string;
   /** What the figures are, said after the status: `funding = current estimate, pays 08:00 UTC`. */
   note?: string;
+  /**
+   * Shorter forms of `note`, longest first, that a capture's status line too
+   * narrow for the whole note says instead before it leaves the note out.
+   */
+  noteVariants?: string[];
   /**
    * When the figures reach readers and when the next ones are due, said right
    * after the as-of date: `published Fri 9 Oct, next settlement Thu 15 Oct,
    * published Mon 26 Oct` for a settlement a regulator publishes days later.
    */
   schedule?: string;
+  /**
+   * Shorter forms of `schedule`, longest first, that a status line too narrow
+   * for the whole one says instead, with the not-a-feed basis left out first:
+   * when the figures were published outlasts what kind of data they are.
+   */
+  scheduleVariants?: string[];
 }
 
 interface HeadlessPaneResultBase {
@@ -395,6 +459,8 @@ export interface HeadlessRowsResult extends HeadlessPaneResultBase {
    * (an ISO date or instant), for rows of several series dated apart: each
    * exported row names them in `currency_or_unit`, `symbol_or_series` and
    * `as_of`, as a bundle section's `rowUnitKey`, `rowSymbolKey` and `rowAsOfKey` do.
+   * A column whose `unitKey` is `rowUnitKey` exports its figures bare under its
+   * own header, the row's unit named once in `currency_or_unit`.
    */
   rowUnitKey?: string;
   rowSymbolKey?: string;
@@ -516,6 +582,10 @@ export interface HeadlessSeries {
   symbol?: string;
   /** The bar interval or observation frequency the points are at (`1d`, `1mo`, `daily`), as served, not as asked. */
   interval?: string;
+  /** Decimal places the text report prints the latest value to (a correlation to 3); JSON and CSV keep every digit. */
+  textDecimals?: number;
+  /** Each point's `value` is its bar's close: `--csv` and `--ndjson` write Close alone, JSON keeps both. */
+  valueIsClose?: boolean;
   points: HeadlessSeriesPoint[];
 }
 
@@ -542,6 +612,13 @@ export interface HeadlessPaneDefinition<Shape extends HeadlessPaneShape = Headle
   discovery?: {
     id?: string;
     aliases?: string[];
+    /**
+     * Words that are no function's code but ask for this function's data
+     * (IVOL, IV for implied volatility). They do not open it, since one word
+     * can mean several functions: `fn IVOL` answers with the functions it
+     * means and the commands that run them, and `catalog ivol` lists them first.
+     */
+    suggestFor?: string[];
     intents?: string[];
     dataRequirements?: string[];
     limitations?: string[];

package/src/types/instrument.ts

@@ -81,4 +81,7 @@ export interface InstrumentSearchResult {
   formerIssuer?: { symbol: string; name: string; until: string; successor?: { symbol: string; name: string | null } };
   /** A US listing that no longer trades, found by its exact symbol (TWTR). Untrusted until parsed. */
   delisting?: ListingDelisting;
+  /** The company's home line, its common stock on its home exchange (7203 on JPX for Toyota), sent by newer
+   * cloud servers. Search lists it before the company's depositary receipts and other lines. Only `true` counts. */
+  homeListing?: boolean;
 }

package/src/types/issuer-listings.ts

@@ -0,0 +1,28 @@
+/**
+ * Every listing of one company, as Gloom Cloud's company universe groups
+ * them: share classes, a US receipt and its home line, dual listings. RCI on
+ * the NYSE and RCI.B on the TSX are both Rogers Communications.
+ */
+
+/** One listing, written as the service writes it: bare on a US venue (RCI), SYMBOL:EXCHANGE elsewhere (RCI.B:TSX). */
+interface IssuerListing {
+  symbol: string;
+  /** The canonical venue code. */
+  exchange: string;
+  name: string;
+  /** The company's primary line. */
+  primary: boolean;
+}
+
+export interface IssuerListings {
+  /** The service's key for the company (cik:733099). */
+  issuer: string;
+  name: string;
+  /**
+   * Where the company is from, ISO 3166 alpha-2: its primary line's country,
+   * or the SEC address of a foreign company whose only lines are in the US.
+   */
+  country: string;
+  /** The primary line first. */
+  listings: IssuerListing[];
+}