gloomberb 0.15.4 → 0.15.6

package/README.md

@@ -72,7 +72,9 @@ Press `Ctrl+P` to open the command bar, or press `` ` `` to search for a ticker.
 | `DES AAPL` | Company details |
 | `GP NVDA` | Price chart |
 | `OVDV AAPL` | Implied-volatility surface and options term structure |
+| `OPX SPY` / `GEX SPY` | Open interest by strike and expiry, max pain and dealer gamma ([method](docs/options-positioning.md)) |
 | `HVG AAPL` / `HVT AAPL` | Realized volatility and volatility cones |
+| `SEAS AAPL` | Seasonality: monthly returns by year and year overlays |
 | `COT [code or root]` | CFTC positioning and cross-market extremes |
 | `TOP` | Market stories |
 | `WIRP` / `FFIP` | US rate path and conditional FOMC probabilities |
@@ -117,7 +119,7 @@ The app also counts how often you open each function, from the command bar, a me
 
 Neither contains anything from your workspace: no tickers, arguments, portfolios, watchlists, layouts, settings or queries. Both carry a random install id stored in `~/.gloomberb/install-id` (in the browser, in local storage).
 
-The usage setting also covers command bar searches. When you are signed in, a search you finish in the command bar (you pause typing or run something, never each keystroke) is stored with your account to improve search: its text, the AI suggestions it got and the result you picked. Searches are kept for 12 months and deleted with your account.
+The usage setting also covers command bar searches. When you are signed in, a search you finish in the command bar (you pause typing or run something, never each keystroke) is stored with your account to improve search: its text, the AI suggestions it got and the result you picked. Searches are deleted with your account.
 
 To turn either off, run `Crash Reports` or `Usage Counts` from the command bar, or:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gloomberb",
-  "version": "0.15.4",
+  "version": "0.15.6",
   "packageManager": "bun@1.3.11",
   "description": "Market research and portfolio tracker for the terminal",
   "module": "src/public/index.ts",
@@ -67,11 +67,13 @@
     "plugins:registry:check": "bun run scripts/check-registry-plugins.ts",
     "web:proxy-hosts": "bun run scripts/generate-web-proxy-hosts.ts",
     "web:proxy-hosts:check": "bun run scripts/generate-web-proxy-hosts.ts --check",
-    "typecheck": "bun run typecheck:opentui && bun run typecheck:dom && bun run typecheck:cloudflare && bun run typecheck:scripts",
+    "typecheck": "bun run typecheck:opentui && bun run typecheck:dom && bun run typecheck:cloudflare && bun run typecheck:scripts && bun run typecheck:plugin-tests",
     "typecheck:opentui": "tsc --project tsconfig.opentui.json",
     "typecheck:dom": "tsc --project tsconfig.dom.json",
     "typecheck:cloudflare": "tsc --project tsconfig.cloudflare.json",
     "typecheck:scripts": "tsc --project tsconfig.scripts.json",
+    "typecheck:plugin-tests": "tsc --project tsconfig.plugin-tests.json",
+    "knip": "bunx knip@6.39.0",
     "test": "bun test",
     "benchmark:tui:navigation": "bun run scripts/benchmark-tui-navigation.ts",
     "benchmark:tui:compare": "bun run scripts/benchmark-tui-compare.ts",
@@ -108,7 +110,6 @@
     "@opentui/core": "^0.3.2",
     "@opentui/react": "^0.3.2",
     "@tanstack/react-virtual": "^3.14.2",
-    "fast-xml-parser": "5.7.3",
     "hls.js": "1.6.13",
     "jimp": "1.6.1",
     "qrcode-generator": "^2.0.4",

package/src/api-client/askg.ts

@@ -83,7 +83,7 @@ export interface ASKGConversationTool {
   note?: string;
 }
 
-export interface ASKGConversationMessage {
+interface ASKGConversationMessage {
   seq: number;
   role: "user" | "assistant";
   text: string;
@@ -224,7 +224,7 @@ function isAskgEvent(value: unknown): value is ASKGSseEvent {
 }
 
 /** Parses one frame payload, ignoring keep-alives and unknown shapes. */
-export function parseASKGFrame(frame: SseFrame): ASKGSseEvent | null {
+function parseASKGFrame(frame: SseFrame): ASKGSseEvent | null {
   const data = frame.data.trim();
   if (!data || data === "[DONE]") return null;
   try {

package/src/api-client/auth.ts

@@ -6,6 +6,7 @@ import type {
   AuthUser,
   BuildoutAccountResponse,
   BuildoutTokenResponse,
+  CalendarFeed,
   CloudAccountPlan,
   CloudBrowserHandoffResponse,
   CloudPricing,
@@ -250,6 +251,33 @@ export class CloudAuthApi {
     );
   }
 
+  /** The private calendar feed link, or null until it is first created. */
+  async getCalendarFeed(): Promise<CalendarFeed | null> {
+    const result = await this.options.request<{ feed: CalendarFeed | null }>(
+      "/account/calendar-feed",
+      { method: "GET" },
+    );
+    return result.feed;
+  }
+
+  /** The calendar feed link, created on first use. */
+  async ensureCalendarFeed(): Promise<CalendarFeed> {
+    const result = await this.options.request<{ feed: CalendarFeed }>(
+      "/account/calendar-feed",
+      { method: "POST", body: JSON.stringify({}) },
+    );
+    return result.feed;
+  }
+
+  /** A new calendar feed link; the old one stops working. */
+  async rotateCalendarFeed(): Promise<CalendarFeed> {
+    const result = await this.options.request<{ feed: CalendarFeed }>(
+      "/account/calendar-feed/rotate",
+      { method: "POST", body: JSON.stringify({}) },
+    );
+    return result.feed;
+  }
+
   async updateAccountProfile(
     update: AccountProfileUpdate,
   ): Promise<AccountProfile> {

package/src/api-client/cot.ts

@@ -1,7 +1,7 @@
 export type CotFamily = "legacy" | "disaggregated"
 export type CotClass = "noncommercial" | "commercial" | "producer" | "swap" | "managed-money" | "other-reportable" | "nonreportable"
-export interface CotPosition { long: number | null; short: number | null; spreading: number | null }
-export interface CotPercentile {
+interface CotPosition { long: number | null; short: number | null; spreading: number | null }
+interface CotPercentile {
   value: number | null
   rank: number | null
   sampleCount: number
@@ -24,7 +24,7 @@ export interface CotClassSummary extends CotPosition {
   percentile1Y: CotPercentile
   percentile3Y: CotPercentile
 }
-export interface CotMarket {
+interface CotMarket {
   contractCode: string
   marketName: string
   exchangeCode: string

package/src/api-client/crypto-markets.ts

@@ -1,5 +1,5 @@
 /** Completed UTC daily closes, oldest first, one slot per calendar day. */
-export interface CryptoDailyCloses {
+interface CryptoDailyCloses {
   start: string;
   closes: Array<number | null>;
 }

package/src/api-client/data.ts

@@ -6,6 +6,7 @@ import type { CryptoMarketsPayload } from "./crypto-markets";
 import type { CentralBankRatesPayload } from "./central-bank-rates";
 import type { EstimateRevisionsPayload } from "./estimate-revisions";
 import type { MoneyMarketsPayload } from "./money-markets";
+import type { CloudCurveId, CloudCurveView, CloudWorldCurves } from "./yield-curves";
 import type { CdxBoardPayload, CloudCreditBoardParams, SovrBoardPayload } from "./credit-boards";
 import type { ShortVolumePayload, ShortVolumeScope } from "./short-volume";
 import type { SocialMentionDayPosts, SocialMentionsPayload, SocialMentionsRange } from "./social-mentions";
@@ -159,6 +160,11 @@ export class CloudDataApi {
     return this.request<T>(`/cloud/iv/${path}`, init);
   }
 
+  /** Options positioning (OPX): open interest by strike and expiry, max pain, dealer gamma. */
+  optionsPositioning<T>(path: string, init?: RequestInit) {
+    return this.request<T>(`/cloud/options/${path}`, init);
+  }
+
   async searchInstruments(
     query: string,
     limit = 10,
@@ -360,6 +366,17 @@ export class CloudDataApi {
     return this.request<CloudYieldPointPayload[]>("/cloud/econ/yield-curve");
   }
 
+  /** A curve's session on or before `date` (latest without one), with look-backs and spreads. */
+  async getCloudCurve(curve: CloudCurveId, date?: string | null): Promise<CloudCurveView> {
+    const query = date ? `?${new URLSearchParams({ date })}` : "";
+    return this.request<CloudCurveView>(`/cloud/econ/curves/${encodeURIComponent(curve)}${query}`, { signal: AbortSignal.timeout(30_000) });
+  }
+
+  /** Each market's latest curve and the session before, each on its own date. */
+  async getCloudWorldCurves(): Promise<CloudWorldCurves> {
+    return this.request<CloudWorldCurves>("/cloud/econ/curves", { signal: AbortSignal.timeout(30_000) });
+  }
+
   async getCloudCryptoMarkets(): Promise<CryptoMarketsPayload> {
     return this.request<CryptoMarketsPayload>("/cloud/crypto/markets", { signal: AbortSignal.timeout(45_000) });
   }

package/src/api-client/debt-maturities.ts

@@ -8,7 +8,7 @@ export interface DebtFact {
   filed: string;
   form: string;
 }
-export interface DebtBorrowingCost {
+interface DebtBorrowingCost {
   value: number;
   interest: DebtFact;
   opening: DebtFact[];
@@ -16,7 +16,7 @@ export interface DebtBorrowingCost {
   periodStart: string;
   periodEnd: string;
 }
-export interface DebtPercentile {
+interface DebtPercentile {
   value: number | null;
   rank: number | null;
   sampleCount: number;

package/src/api-client/earnings.ts

@@ -1,7 +1,7 @@
 /** Before the open, during the session, after the close. */
 export type EarningsTiming = "bmo" | "dmh" | "amc";
 
-export interface EarningsImpliedMove {
+interface EarningsImpliedMove {
   /** Straddle over spot, the move priced in either direction. */
   move: number;
   straddle: number;
@@ -16,7 +16,7 @@ export interface EarningsImpliedMove {
   at: string;
 }
 
-export interface EarningsRealizedMove {
+interface EarningsRealizedMove {
   /** Signed: the close after the report over the close before it, minus one. */
   move: number;
   baseSession: string;
@@ -59,7 +59,7 @@ export interface EarningsCalendarPayload {
   reports: EarningsCalendarReport[];
 }
 
-export interface EarningsHistoryReport extends EarningsReport {
+interface EarningsHistoryReport extends EarningsReport {
   revenueActual: number | null;
 }
 

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

@@ -56,7 +56,7 @@ export const CATEGORY_FIELDS = [
   "industry",
 ] as const;
 export type NumericField = (typeof NUMERIC_FIELDS)[number];
-export type CategoryField = (typeof CATEGORY_FIELDS)[number];
+type CategoryField = (typeof CATEGORY_FIELDS)[number];
 export type ScreenField = NumericField | CategoryField;
 export type ScreenOperator =
   "gte" | "lte" | "gt" | "lt" | "eq" | "between" | "in" | "present" | "missing";
@@ -110,7 +110,7 @@ export interface ScreenRow {
   metrics: Record<NumericField, ScreenMetric>;
   warnings: string[];
 }
-export interface ScreenCoverage {
+interface ScreenCoverage {
   covered: number;
   skipped: number;
   knownByField: Record<NumericField, number>;

package/src/api-client/estimate-revisions.ts

@@ -1,4 +1,4 @@
-export interface PercentileStatistics {
+interface PercentileStatistics {
   percentile: number | null;
   rank: number | null;
   samples: number;
@@ -6,8 +6,8 @@ export interface PercentileStatistics {
   max: number | null;
   mean: number | null;
 }
-export type EstimateStatus = "available" | "partial" | "unavailable";
-export interface EstimateSourceState {
+type EstimateStatus = "available" | "partial" | "unavailable";
+interface EstimateSourceState {
   status: EstimateStatus;
   fetchedAt: string | null;
   stale: boolean;
@@ -24,7 +24,7 @@ export interface EstimateObservation {
   relativeRange: number | null;
   source: "yahoo" | "yahoo-eps-trend";
 }
-export interface RevisionBreadth {
+interface RevisionBreadth {
   days: 7 | 30;
   up: number | null;
   down: number | null;
@@ -76,7 +76,7 @@ export interface EstimateSurprise {
   samples: number;
   source: string;
 }
-export interface EstimateGuidance {
+interface EstimateGuidance {
   callDate: string | null;
   fiscalYear: number;
   fiscalQuarter: number;

package/src/api-client/index.ts

@@ -4,7 +4,7 @@ import {
   parseMarketplaceLayoutList,
   type LayoutMarketplaceEntry,
   type LayoutMarketplacePayload,
-} from "../layout-marketplace/payload";
+} from "../shares/portable-layout";
 import {
   type CloudLayoutEntry,
   type LayoutRequirement,
@@ -38,18 +38,14 @@ import type {
   PersistedAuthUser
 } from "./types";
 
-export { ASKGTransportError } from "./askg";
-export type { ASKGToolResultOutcome, ASKGTransport } from "./askg";
 export { setCloudApiFetchTransport } from "./request";
 export { NoteConflictError } from "./notes";
 export { ThesisConflictError, ThesisGoalpostError } from "./theses";
 export { TeamRevisionConflictError } from "./views";
-export { TEAM_ACCENT_COLORS } from "./types";
 export type * from "./types";
 export type {
   CommandSearchChoice,
   CommandSearchOutcome,
-  CommandSearchReport,
   CrashReportError,
   CrashReportKind,
   CrashReportSurface,
@@ -364,7 +360,7 @@ class GloomApiClient {
     event: import("./research-activity").ResearchActivity; eventId: string;
     surface: "web" | "desktop" | "tui" | "cli"; anonymousId?: string;
     attribution?: Record<string, string>; feature?: import("./research-activity").ResearchFeature;
-    tab?: string;
+    tab?: string; desks?: readonly string[];
   }): Promise<void> {
     await this.request("/activity/research", { method: "POST", body: JSON.stringify(payload) });
   }
@@ -409,6 +405,9 @@ class GloomApiClient {
   getBuildoutAccount = this.auth.getBuildoutAccount.bind(this.auth);
   getBuildoutToken = this.auth.getBuildoutToken.bind(this.auth);
   updateAccountProfile = this.auth.updateAccountProfile.bind(this.auth);
+  getCalendarFeed = this.auth.getCalendarFeed.bind(this.auth);
+  ensureCalendarFeed = this.auth.ensureCalendarFeed.bind(this.auth);
+  rotateCalendarFeed = this.auth.rotateCalendarFeed.bind(this.auth);
 
   async getSyncSnapshot(): Promise<CloudSyncSnapshotResponse> {
     return this.request<CloudSyncSnapshotResponse>("/sync/snapshot", { method: "GET" });
@@ -542,8 +541,9 @@ class GloomApiClient {
    * Resolves a natural-language command-bar query into runnable command-bar
    * inputs. Requires a verified session; free accounts are included. The
    * request is bounded client-side so a stalled upstream cannot hold the
-   * command bar in its loading state. The server keeps the query, and
-   * answers with a `searchId`, only when asked with `log: true`.
+   * command bar in its loading state. The server keeps the query and answers
+   * with a `searchId` unless told `log: false`, so an opt-out has to be sent
+   * explicitly.
    */
   async assistCommand(
     query: string,
@@ -565,7 +565,7 @@ class GloomApiClient {
         body: JSON.stringify({
           query: query.trim().slice(0, ASSIST_QUERY_MAX_LENGTH),
           commands: commands.slice(0, ASSIST_COMMAND_LIMIT).map(capAssistArgOptions),
-          ...(options?.log === true ? { log: true } : {}),
+          ...(options?.log !== undefined ? { log: options.log } : {}),
         }),
         signal: controller.signal,
       });
@@ -700,6 +700,7 @@ class GloomApiClient {
   getCloudMoneyMarkets = this.data.getCloudMoneyMarkets.bind(this.data);
   equityScreener = this.data.equityScreener.bind(this.data);
   impliedVolatility = this.data.impliedVolatility.bind(this.data);
+  optionsPositioning = this.data.optionsPositioning.bind(this.data);
   getCloudDebtMaturities = this.data.getCloudDebtMaturities.bind(this.data);
   getCloudRevenueBreakdown = this.data.getCloudRevenueBreakdown.bind(this.data);
   getCloudMnaDeals = this.data.getCloudMnaDeals.bind(this.data);
@@ -716,6 +717,8 @@ class GloomApiClient {
   getCloudCotContract = this.data.getCloudCotContract.bind(this.data);
   getCloudTape = this.data.getCloudTape.bind(this.data);
   getCloudYieldCurve = this.data.getCloudYieldCurve.bind(this.data);
+  getCloudCurve = this.data.getCloudCurve.bind(this.data);
+  getCloudWorldCurves = this.data.getCloudWorldCurves.bind(this.data);
   getCloudCds = this.data.getCloudCds.bind(this.data);
   getCloudCdsHistory = this.data.getCloudCdsHistory.bind(this.data);
   getCloudCdxBoard = this.data.getCloudCdxBoard.bind(this.data);
@@ -748,5 +751,3 @@ class GloomApiClient {
 }
 
 export const apiClient = new GloomApiClient();
-
-export type { FuturesCurveAsOfPayload, FuturesCurvePayload, FuturesContract } from "./futures-curve";

package/src/api-client/ipo.ts

@@ -6,10 +6,10 @@
 /** Where a deal is in its life. A deal moves forward, except to postponed or withdrawn. */
 export type IpoStatus = "filed" | "upcoming" | "priced" | "listed" | "postponed" | "withdrawn";
 
-export type IpoListingType = "ipo" | "spac" | "direct" | "reit" | "introduction" | "dual" | "other";
+type IpoListingType = "ipo" | "spac" | "direct" | "reit" | "introduction" | "dual" | "other";
 
 /** How sure the listing date is: a target, a date the venue has set, or the day it traded. */
-export type IpoDateKind = "expected" | "confirmed" | "actual";
+type IpoDateKind = "expected" | "confirmed" | "actual";
 
 export type IpoRegion = "us" | "apac" | "europe" | "other";
 
@@ -17,9 +17,9 @@ export type IpoRegion = "us" | "apac" | "europe" | "other";
  * ISO 10383 MIC of a listing venue, such as `XNAS`, `XHKG` or `XTKS`. The
  * server adds venues over time, so any code may arrive.
  */
-export type IpoMic = string;
+type IpoMic = string;
 
-export interface IpoFirstDay {
+interface IpoFirstDay {
   /** The first session's venue-local date. */
   session: string;
   open: number | null;

package/src/api-client/market-movers.ts

@@ -13,7 +13,7 @@ export type CloudSessionMoversSide = "up" | "down" | "active";
 export type CloudSessionPhase = "pre" | "regular" | "post" | "closed";
 
 /** A trading halt, an 8-K, or a news story in the list's own window (see docs/quote-board-data.md). */
-export type CloudSessionCatalyst = "halt" | "filing" | "news";
+type CloudSessionCatalyst = "halt" | "filing" | "news";
 
 export interface CloudSessionMoverItem {
   rank: number;

package/src/api-client/mna.ts

@@ -7,7 +7,7 @@
 /** Reported talks, a signed or launched deal, or its end. */
 export type MnaStatus = "talks" | "pending" | "completed" | "terminated";
 
-export type MnaConsideration = "cash" | "stock" | "mixed" | "undisclosed";
+type MnaConsideration = "cash" | "stock" | "mixed" | "undisclosed";
 
 export interface MnaParty {
   name: string;
@@ -88,7 +88,7 @@ export interface MnaDealsPayload {
   asOf: string;
 }
 
-export type MnaEventKind =
+type MnaEventKind =
   | "talks"
   | "announced"
   | "amended"

package/src/api-client/normalizers.ts

@@ -38,7 +38,7 @@ export function normalizeSavedSearchResponse(
  * join it into search text, and hand it to a badge, and a null reaches each of
  * those as an empty chip, the literal "null", or a crash.
  */
-export function normalizeSearchHit(hit: CloudSearchHit): CloudSearchHit {
+function normalizeSearchHit(hit: CloudSearchHit): CloudSearchHit {
   return hit.ticker ? hit : { ...hit, ticker: "" };
 }
 

package/src/api-client/paths.ts

@@ -35,7 +35,7 @@ export type CloudCdsHistoryParams = {
   days?: number;
 };
 
-export type CloudCongressChamber = "all" | "house" | "senate";
+type CloudCongressChamber = "all" | "house" | "senate";
 
 export type CloudCongressHouseParams = {
   /** Which feed to read; House when omitted. */
@@ -104,7 +104,7 @@ const CRYPTO_QUOTE = /[-/](USD|USDT|USDC|EUR|GBP|BTC)$/;
 
 export type CloudLogoKind = "ticker" | "crypto";
 
-export function normalizeCloudLogoSymbol(
+function normalizeCloudLogoSymbol(
   kind: CloudLogoKind,
   symbol: string,
 ): string | null {

package/src/api-client/plan-rules.ts

@@ -41,7 +41,7 @@ export function resolveTrialEndsAt(user: PlanAccessUser | null | undefined): Dat
   return Number.isNaN(endsAt.getTime()) ? null : endsAt;
 }
 
-export function isTrialActive(user: PlanAccessUser | null | undefined, now = Date.now()): boolean {
+function isTrialActive(user: PlanAccessUser | null | undefined, now = Date.now()): boolean {
   if (user?.emailVerified !== true) return false;
   // Card-backed trials run as plan "pro" with a trialing subscription; the server
   // only sends `trialEndsAt` while the subscription is actually in its trial.
@@ -49,7 +49,7 @@ export function isTrialActive(user: PlanAccessUser | null | undefined, now = Dat
   return !!endsAt && endsAt.getTime() > now;
 }
 
-export function trialDaysLeft(user: PlanAccessUser | null | undefined, now = Date.now()): number {
+function trialDaysLeft(user: PlanAccessUser | null | undefined, now = Date.now()): number {
   const endsAt = resolveTrialEndsAt(user);
   if (!endsAt) return 0;
   const remainingMs = endsAt.getTime() - now;

package/src/api-client/rates.ts

@@ -1,5 +1,5 @@
 /** Gloom Cloud rate-path contract. Rates are percentage points; probabilities are fractions. */
-export interface RateMetric {
+interface RateMetric {
   value: number | null;
   asOf: string | null;
   percentile: number | null;

package/src/api-client/request.ts

@@ -66,7 +66,7 @@ export function setCloudApiFetchTransport(
  * The fetch to use for a response that must be read while it arrives, or null
  * when the installed transport buffers whole responses.
  */
-export function getCloudApiStreamFetch(): CloudApiStreamFetch | null {
+function getCloudApiStreamFetch(): CloudApiStreamFetch | null {
   if (cloudApiTransportInstalled) {
     if (cloudApiStreamFetch) return cloudApiStreamFetch;
     // A transport that declares streaming returns a real Response.

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

@@ -318,12 +318,14 @@ function attributionPayload(): Record<string, string> | undefined {
 /**
  * Counts milestones once per feature/session/account, never their content.
  * Native surfaces report anonymously only with an identifier the website
- * handed over; they still never mint one of their own.
+ * handed over; they still never mint one of their own. `desks` rides on the
+ * end of the first-run funnel: the desks picked at "What do you trade?".
  */
 export function recordResearchActivity(
   event: ResearchActivity,
   feature?: ResearchFeature,
   tab?: string,
+  desks?: readonly string[],
 ): void {
   const target = getCurrentPluginTarget();
   const user = apiClient.getCurrentUser();
@@ -342,6 +344,7 @@ export function recordResearchActivity(
       attribution: attributionPayload(),
       feature,
       tab,
+      desks,
     })
     .catch(() => {
       sent.delete(key);

package/src/api-client/social-mentions.ts

@@ -1,6 +1,6 @@
 export type SocialMentionsRange = "1y" | "5y" | "max";
 
-export interface SocialMentionDay {
+interface SocialMentionDay {
   /** UTC day. */
   day: string;
   mentions: number;