gloomberb 0.16.5 → 0.17.0

package/src/api-client/normalizers.ts

@@ -6,7 +6,11 @@ import type {
   ChatMessage,
   ChatMessageOrigin,
   ChatNotification,
+  ChatReaction,
+  ChatReactionUser,
   ChatStateResponse,
+  ChatUserBadge,
+  ChatUserSummary,
   CloudSavedSearch,
   CloudSearchHit,
   CloudSearchResponse,
@@ -15,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 }`.
@@ -80,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
@@ -98,10 +123,16 @@ export function normalizeChatMessage(message: ChatMessage): ChatMessage {
       : {}),
   };
   if ("attachments" in message) normalized.attachments = normalizeChatAttachments(message.attachments);
+  if ("reactions" in message) normalized.reactions = normalizeChatReactions(message.reactions);
   if (message.origin !== undefined && !CHAT_MESSAGE_ORIGINS.includes(message.origin)) delete normalized.origin;
   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;
 }
 
@@ -117,6 +148,35 @@ export function normalizeChatDiscordLink(value: unknown): ChatDiscordLink {
   };
 }
 
+/** Reactions as the server sent them, dropping anything malformed. */
+export function normalizeChatReactions(value: unknown): ChatReaction[] {
+  if (!Array.isArray(value)) return [];
+  const reactions: ChatReaction[] = [];
+  for (const entry of value) {
+    if (!entry || typeof entry !== "object") continue;
+    const raw = entry as Record<string, unknown>;
+    if (typeof raw.emoji !== "string" || !raw.emoji) continue;
+    const count = typeof raw.count === "number" && Number.isFinite(raw.count) ? Math.max(0, Math.floor(raw.count)) : 0;
+    if (count === 0) continue;
+    const users = Array.isArray(raw.users)
+      ? raw.users.flatMap((user): ChatReactionUser[] => {
+        if (!user || typeof user !== "object") return [];
+        const candidate = user as Record<string, unknown>;
+        if (typeof candidate.id !== "string") return [];
+        const accountType = candidate.accountType;
+        return [{
+          id: candidate.id,
+          username: typeof candidate.username === "string" ? candidate.username : null,
+          displayName: typeof candidate.displayName === "string" ? candidate.displayName : "User",
+          ...(accountType === "human" || accountType === "managed_llm" || accountType === "discord" ? { accountType } : {}),
+        }];
+      })
+      : [];
+    reactions.push({ emoji: raw.emoji, count, me: raw.me === true, users });
+  }
+  return reactions;
+}
+
 export function normalizeChatMessages(messages: ChatMessage[]): ChatMessage[] {
   return messages.map((message) => normalizeChatMessage(message));
 }
@@ -139,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/perps.ts

@@ -147,6 +147,14 @@ export interface PerpBoardPayload {
   access: "pro" | "preview"; sources?: unknown[];
 }
 export interface PerpEquityListing { symbol: string; exchange: string }
+/**
+ * The batch lookup a watchlist or portfolio makes: one entry per requested listing, in its order, with the contract
+ * the single equity lookup would list first, or none. `listing` is null when the server cannot read the listing.
+ */
+export interface PerpEquitiesPayload {
+  status: string; asOf: string | null; access: "pro" | "preview"; locked: number;
+  results: { listing: PerpEquityListing | null; market: PerpBoardRow | null }[];
+}
 export interface PerpHistoryPayload {
   status: string; marketId: string; rows: PerpHistoryPoint[]; funding: PerpFunding[]; candles: PerpCandle[];
   /** Absent from servers older than the long/short series: read as empty. */

package/src/api-client/request.ts

@@ -408,8 +408,17 @@ export class CloudApiRequestTransport {
     // Crash reports, usage counts and command-search reports are background
     // traffic: a rate-limited, timed-out or missing one must not show up as a
     // Cloud outage in the connections pane. Nor must the map's probe for geo
-    // layers, which a server without them answers with 404.
-    if (path.startsWith("/telemetry/") || path === "/assist/searches" || path === "/cloud/geo/layers") return request();
+    // 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.
+    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,
       operation,

package/src/api-client/socket.ts

@@ -3,6 +3,7 @@ import type {
   AuthUser,
   ChatMessage,
   ChatNotification,
+  ChatReactionsUpdate,
   CloudQuotePayload,
   QuoteStreamTarget,
   ScannerFeedEvent,
@@ -12,6 +13,7 @@ import type {
 import {
   normalizeChatMessage,
   normalizeChatNotification,
+  normalizeChatReactions,
   normalizeTeamNotification,
 } from "./normalizers";
 import { debugLog } from "../utils/debug-log";
@@ -41,6 +43,7 @@ const cloudApiLog = debugLog.createLogger("cloud-api");
 type ChannelListener = (message: ChatMessage) => void;
 type ChatNotificationListener = (notification: ChatNotification) => void;
 type ChatPresenceListener = (onlineCount: number) => void;
+type ChatReactionsListener = (update: ChatReactionsUpdate) => void;
 type TeamNotificationListener = (notification: TeamNotification) => void;
 type CloudEventListener = (data: unknown) => void;
 type QuoteListener = (
@@ -106,6 +109,7 @@ export class CloudApiSocket {
   private readonly chatNotificationListeners =
     new Set<ChatNotificationListener>();
   private readonly chatPresenceListeners = new Set<ChatPresenceListener>();
+  private readonly chatReactionsListeners = new Set<ChatReactionsListener>();
   private readonly teamNotificationListeners =
     new Set<TeamNotificationListener>();
   private readonly cloudEventListeners = new Map<
@@ -245,6 +249,14 @@ export class CloudApiSocket {
     };
   }
 
+  /** A message's reactions changed in a channel this socket reads. */
+  subscribeChatReactions(listener: ChatReactionsListener): () => void {
+    this.chatReactionsListeners.add(listener);
+    return () => {
+      this.chatReactionsListeners.delete(listener);
+    };
+  }
+
   subscribeChatPresence(listener: ChatPresenceListener): () => void {
     this.chatPresenceListeners.add(listener);
     return () => {
@@ -500,6 +512,7 @@ export class CloudApiSocket {
     this.connectionListeners.clear();
     this.chatNotificationListeners.clear();
     this.chatPresenceListeners.clear();
+    this.chatReactionsListeners.clear();
     this.teamNotificationListeners.clear();
     this.cloudEventListeners.clear();
     this.quoteSubscriptions.clear();
@@ -575,6 +588,22 @@ export class CloudApiSocket {
       return;
     }
 
+    if (
+      parsed?.type === "chat.reactions" &&
+      typeof parsed.channelId === "string" &&
+      typeof parsed.data?.messageId === "string"
+    ) {
+      const update: ChatReactionsUpdate = {
+        channelId: parsed.channelId,
+        messageId: parsed.data.messageId,
+        reactions: normalizeChatReactions(parsed.data.reactions),
+      };
+      for (const listener of this.chatReactionsListeners) {
+        listener(update);
+      }
+      return;
+    }
+
     if (parsed?.type === "chat.notification" && parsed.data) {
       const notification = normalizeChatNotification(
         parsed.data as ChatNotification,

package/src/api-client/themes.ts

@@ -15,6 +15,12 @@ export interface ThemeSummary {
   worst: { symbol: string; changePercent: number } | null;
   stale: boolean;
 }
+/**
+ * A member's figures. `price`, `changePercent` and the returns are the regular
+ * session's: outside it, its close and that close's move. The extended fields
+ * are the pre-market or after-hours print measured from that close; a server
+ * sends them only when there is one, and older servers never do.
+ */
 export interface ThemeMember extends Record<ThemePeriod | "price", number | null> {
   symbol: string;
   name: string | null;
@@ -22,7 +28,22 @@ export interface ThemeMember extends Record<ThemePeriod | "price", number | null
   present: boolean;
   asOf: Record<ThemePeriod | "price", string | null>;
   stale: boolean;
+  extendedSession?: "PRE" | "POST" | null;
+  extendedPrice?: number | null;
+  extendedChange?: number | null;
+  extendedChangePercent?: number | null;
+}
+interface SnapshotMetadata {
+  /** When the server put the snapshot together, not a trade time. */
+  asOf: string;
+  snapshotId: string;
+  stale: boolean;
+  /** The US market as the server's delayed board reads it. Absent from older servers. */
+  session?: "PRE" | "REGULAR" | "POST" | "CLOSED" | null;
+  /** Outside the regular session, the completed session every figure describes; null while one trades. */
+  regularSessionDate?: string | null;
+  /** When that session closed, in epoch milliseconds (13:00 New York on an early close). */
+  regularSessionClosedAt?: number | null;
 }
-interface SnapshotMetadata { asOf: string; snapshotId: string; stale: boolean }
 export interface ThemesPayload extends SnapshotMetadata { themes: ThemeSummary[] }
 export interface ThemeMembersPayload extends SnapshotMetadata { theme: ThemeSummary; members: ThemeMember[] }

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[];
 }
 
 /**
@@ -49,6 +62,33 @@ export interface ChatAttachment {
   url: string;
 }
 
+/** Someone who reacted, as a reaction lists the first few. */
+export interface ChatReactionUser {
+  id: string;
+  username: string | null;
+  displayName: string;
+  accountType?: ChatAccountType | null;
+}
+
+/**
+ * One emoji on a message: how many reacted, whether you did, and the first
+ * few who did, oldest first. `emoji` is the character, or `:name:` for a
+ * custom Discord server emoji.
+ */
+export interface ChatReaction {
+  emoji: string;
+  count: number;
+  me: boolean;
+  users?: ChatReactionUser[];
+}
+
+/** A message's reactions as they stand after a change, from the `chat.reactions` frame or a reaction request. */
+export interface ChatReactionsUpdate {
+  channelId: string;
+  messageId: string;
+  reactions: ChatReaction[];
+}
+
 export interface ChatMessage {
   id: string;
   channelId: string;
@@ -66,12 +106,20 @@ export interface ChatMessage {
   } | null;
   /** Images in display order. A server that predates them leaves this out. */
   attachments?: ChatAttachment[];
+  /**
+   * Emoji reactions in the order they first appeared. Message lists from a
+   * server that knows reactions always carry it; a live copy of a message
+   * (an edit) leaves it out, and the reactions held stay.
+   */
+  reactions?: ChatReaction[];
   /**
    * Only on the author's copy of a public message whose images are still being
    * checked ("pending") or could not be checked ("failed"). Nobody else has the
    * 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. */
@@ -175,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;
@@ -318,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 {
@@ -402,6 +459,10 @@ export interface CloudPricePointPayload {
   low?: number;
   close: number;
   volume?: number;
+  /** A coin's daily bar for the UTC day still forming when served; it has no volume yet. */
+  partial?: boolean;
+  /** A coin's daily bar whose prices were rebuilt from hourly bars; a day the source left empty has no volume. */
+  filled?: boolean;
 }
 
 type CloudEconImpact = "high" | "medium" | "low";
@@ -432,6 +493,13 @@ export interface CloudMacroReleaseDaysPayload {
 export interface CloudFredObservationPayload {
   date: string;
   value: number | null;
+  /**
+   * Who published a value FRED does not list yet, such as a Treasury yield
+   * Gloom Cloud read from the Treasury first. Absent on FRED's own values.
+   */
+  publisher?: string;
+  /** When that publisher's value was first read, ISO in UTC. */
+  publishedAt?: string;
 }
 
 export interface CloudFredSeriesInfoPayload {
@@ -538,6 +606,22 @@ export interface CloudCdsHistoryResponse {
   points: CloudCdsHistoryPointPayload[];
 }
 
+/** An issuer's latest 5Y level: the last point of its history over the last month. */
+export interface CloudCdsLevelPayload {
+  /** The reference entity as the history response names it. */
+  issuer: string;
+  spreadBp: number;
+  date: string;
+}
+
+export interface CloudCdsLevelsResponse {
+  source: string;
+  tenor: string;
+  asOf: string | null;
+  /** Every issuer traded in the last month whose 5Y line has a level in it. */
+  levels: CloudCdsLevelPayload[];
+}
+
 interface CloudShortInterestPointPayload {
   settlementDate: string;
   shortPercentFloat?: number | null;
@@ -1098,7 +1182,7 @@ export interface CloudSearchResponse {
   tookMs: number;
 }
 
-export interface CloudSearchDocumentChunk {
+interface CloudSearchDocumentChunk {
   id: string;
   chunkIndex: number;
   body: string;
@@ -1361,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;

package/src/app/global-shortcuts.ts

@@ -1,4 +1,4 @@
-import { useEffect, useRef, type Dispatch } from "react";
+import { useEffect, useRef, useState, type Dispatch } from "react";
 import { useShortcut } from "../react/input";
 import { useNativeRenderer, useRendererHost, useUiHost } from "../ui";
 import { useDialogState } from "../ui/dialog";
@@ -13,6 +13,7 @@ import { getVisiblePaneCycleOrder } from "../components/layout/pane/cycle-order"
 import { requestFunctionHelp, useFunctionHelpHost } from "../plugins/builtin/help/function-card";
 import { buildRegistryHelpIndex, helpFunctionForPane } from "../plugins/builtin/help/function-index";
 import { recordFunctionOpen } from "../telemetry/usage-counts";
+import { createOneShots } from "../utils/one-shot";
 import { DOCS_PANE_TEMPLATE_ID } from "../docs/content";
 import { registerPaneDocsHandler } from "../docs/requests";
 import { isMoveDownShortcut, isMoveUpShortcut } from "../components/command-bar/keyboard-handlers";
@@ -117,6 +118,10 @@ export function useAppGlobalShortcuts({
   const uiKind = useUiHost().kind;
   const toastHost = useToastHost();
   useKeybindingIssueNotice(keybindings, pluginRegistry, state.initialized);
+  // Every action here runs once per press: a held key, or a terminal that does
+  // not say it is a repeat, must not run it again. Only moving focus between
+  // panes (Tab) and switching layouts by number (idempotent) are left to repeat.
+  const [shots] = useState(createOneShots);
   useFunctionHelpHost({
     closeCommandBar: () => {
       if (state.commandBarOpen) dispatch({ type: "SET_COMMAND_BAR", open: false });
@@ -149,6 +154,23 @@ export function useAppGlobalShortcuts({
 
     const match = matchKeybinding(keybindings, event);
     const action = match?.kind === "action" ? match.id : null;
+    /**
+     * Whether the action already ran for this press or hold. An action that
+     * takes the key (`claims`) swallows the refused ones as well; one that
+     * leaves it to the pane (R) does not, so a pane's own key keeps working.
+     */
+    const ranAlready = (id: string, claims = true): boolean => {
+      const shot = shots.get(id);
+      if (shot.refuses(event)) {
+        if (claims) {
+          event.preventDefault();
+          event.stopPropagation();
+        }
+        return true;
+      }
+      shot.end();
+      return false;
+    };
 
     // Terminals send Ctrl; the browser and the desktop webview send Cmd on
     // macOS, which the OpenTUI host also reports as `super` under the kitty
@@ -172,6 +194,7 @@ export function useAppGlobalShortcuts({
     // The status bar's star line answers the same keys once no toast does,
     // but only over the workspace itself.
     if (action === "notification-action" || action === "notification-dismiss") {
+      if (ranAlready(action)) return;
       const toastHandled = action === "notification-action"
         ? toastHost.activateNewest?.() === true
         : toastHost.dismissNewest?.() === true;
@@ -195,12 +218,14 @@ export function useAppGlobalShortcuts({
       // Ctrl+P and Ctrl+N move the open bar's selection, so a bar chord that
       // is one of them only opens it; Esc and the bar's other chords close it.
       if (state.commandBarOpen && (isMoveUpShortcut(event) || isMoveDownShortcut(event))) return;
+      if (ranAlready(action)) return;
       event.preventDefault();
       event.stopPropagation();
       dispatch({ type: "TOGGLE_COMMAND_BAR" });
       return;
     }
     if (!isDetachedWindow && action === "ticker-search" && !state.commandBarOpen) {
+      if (ranAlready(action)) return;
       event.preventDefault();
       event.stopPropagation();
       dispatch({
@@ -233,6 +258,7 @@ export function useAppGlobalShortcuts({
       // Command and function keys are never text, so they still fire.
       const editing = state.inputCaptured || event.targetEditable === true;
       if (editing && event.ctrl && !(event.meta || event.super)) return;
+      if (ranAlready(`command:${match.command.query}`)) return;
       event.preventDefault();
       event.stopPropagation();
       dispatch({
@@ -246,6 +272,7 @@ export function useAppGlobalShortcuts({
 
     // A function key is never text, so the card opens from a focused field too.
     if (action === "function-help") {
+      if (ranAlready(action)) return;
       event.preventDefault();
       event.stopPropagation();
       recordFunctionOpen({ shortcut: "HELP", externalPluginId: null });
@@ -259,6 +286,7 @@ export function useAppGlobalShortcuts({
     if (state.inputCaptured) return;
 
     if (!isDetachedWindow && action === "help") {
+      if (ranAlready(action)) return;
       event.preventDefault();
       event.stopPropagation();
       pluginRegistry.showPane("help");
@@ -266,13 +294,16 @@ export function useAppGlobalShortcuts({
     }
 
     if (!isDetachedWindow && action === "quit") {
+      if (ranAlready(action, false)) return;
       if (uiKind === "opentui") rendererHost.requestExit();
     } else if (action === "refresh-ticker") {
+      if (ranAlready(action, false)) return;
       if (focusedTickerSymbol) {
         const ticker = state.tickers.get(focusedTickerSymbol);
         if (ticker) refreshTicker(ticker.metadata.ticker, ticker.metadata.exchange, ticker, 0);
       }
     } else if (action === "refresh-all") {
+      if (ranAlready(action, false)) return;
       for (const ticker of state.tickers.values()) {
         refreshTicker(ticker.metadata.ticker, ticker.metadata.exchange, ticker, 1);
       }
@@ -280,10 +311,12 @@ export function useAppGlobalShortcuts({
       // A release that can install itself downloads on its own, so the key is
       // for the one that waits for a restart and for the one that failed.
       if (!isDetachedWindow && canRestartToApply(state.updateProgress)) {
+        if (ranAlready(action)) return;
         event.preventDefault();
         event.stopPropagation();
         restartToApplyUpdate();
       } else if (canRetryUpdate(state)) {
+        if (ranAlready(action)) return;
         event.preventDefault();
         event.stopPropagation();
         startUpdate(state.updateAvailable!);
@@ -296,6 +329,7 @@ export function useAppGlobalShortcuts({
         if (ownerId && disabledPlugins.has(ownerId)) continue;
         const chords = resolvePluginShortcutChords(keybindingsConfig, shortcut);
         if (chords.some((chord) => matchesKeyChord(chord, event))) {
+          if (ranAlready(`plugin:${shortcut.id}`, false)) return;
           shortcut.execute();
           break;
         }

package/src/app/keybindings/actions.ts

@@ -28,6 +28,7 @@ export type CoreKeybindingActionId =
   | "pane-screenshot"
   | "pane-export-csv"
   | "pane-share"
+  | "pane-ask"
   | "layout-gallery"
   | "tidy-windows"
   | "window-move-mode"
@@ -59,6 +60,7 @@ export const PANE_ACTION_IDS = new Set<CoreKeybindingActionId>([
   "pane-screenshot",
   "pane-export-csv",
   "pane-share",
+  "pane-ask",
   "layout-gallery",
   "tidy-windows",
   "window-move-mode",
@@ -225,9 +227,18 @@ export const KEYBINDING_ACTIONS: readonly KeybindingActionDef[] = [
   {
     id: "pane-share",
     category: "Pane Management",
-    description: "Share the focused pane.",
+    description: "Share the focused pane: post a picture to chat or copy its link.",
     defaults: ["CmdOrCtrl+Shift+S"],
   },
+  {
+    id: "pane-ask",
+    category: "Pane Management",
+    description: "Ask Gloom about the focused pane, in a new conversation with the pane attached.",
+    // A for ask. Alt+A first, because it reaches most terminals, where
+    // Ctrl+Shift+A is often the terminal's own select all; the desktop app
+    // advertises the chord on its platform modifier.
+    defaults: ["Alt+A", "CmdOrCtrl+Shift+A"],
+  },
   {
     id: "layout-gallery",
     category: "Pane Management",

package/src/app/pane-runtime/plugin-bindings.ts

@@ -16,8 +16,8 @@ import {
 } from "../../components/layout/shell/visible-layout";
 import { applyPluginToggles } from "../../plugins/ownership";
 import { setLayoutManagerDispatch } from "../../plugins/builtin/layout-manager";
-import { setMarketplaceHost } from "../../plugins/builtin/plugin-marketplace/store";
-import type { InstalledPlugin } from "../../plugins/builtin/plugin-marketplace/model";
+import { setMarketplaceHost } from "../../plugins/marketplace/store";
+import type { InstalledPlugin } from "../../plugins/marketplace/model";
 import {
   listExternalPlugins,
   removeExternalPlugin,