gloomberb 0.16.4 → 0.16.6

package/src/plugins/builtin/gpu/model.ts

@@ -10,6 +10,43 @@ export type GpuTab = typeof GPU_TABS[number]["value"];
 export const gpuTab = (value: unknown): GpuTab => GPU_TABS.find((tab) => tab.value === value)?.value ?? "board";
 export const GPU_MODELS = ["H100", "H200", "B200", "B300", "GB200", "GB300", "A100", "MI300X", "MI355X", "L40S", "RTX PRO 6000"];
 export const gpuArgument = (value: string | null | undefined) => (value ?? "").trim().toUpperCase().replace(/\s+/g, " ");
+const gpuModelRank = (name: string) => GPU_MODELS.indexOf(name) < 0 ? 99 : GPU_MODELS.indexOf(name);
+/** Board order: the GPUs people rent most first, the rest by name. */
+const gpuModelOrder = (a: string, b: string) => gpuModelRank(a) - gpuModelRank(b) || a.localeCompare(b);
+
+/** Every GPU name a reader can ask for: the ones on this board and the ones the full board carries. */
+export const gpuFamilies = (rows: readonly Pick<GpuObservation, "gpuModel">[]) =>
+  [...new Set([...GPU_MODELS, ...rows.map((row) => row.gpuModel)])].sort(gpuModelOrder);
+
+/** A GPU name as typed, for comparison: case, spaces, dashes and underscores do not matter. */
+const gpuKey = (value: string) => value.toLowerCase().replace(/[\s_-]+/g, "");
+
+/**
+ * The GPU a typed name means, so "h100", "H-100" and "H100 80GB SXM" all
+ * read H100. A whole name wins over a longer one it begins ("A10" is not
+ * A100), and the most leading words that name a GPU win over fewer ("RTX PRO
+ * 6000"). Otherwise the first GPU, in board order, whose name begins with
+ * what was typed ("B2" is B200), or that begins it ("H100SXM"). Null when
+ * nothing matches.
+ */
+export function gpuFamily(query: string, families: readonly string[]): string | null {
+  const words = query.trim().split(/[\s_-]+/).filter(Boolean);
+  if (!words.length) return null;
+  const ordered = [...new Set(families)].sort(gpuModelOrder);
+  for (let count = words.length; count > 0; count -= 1) {
+    const key = gpuKey(words.slice(0, count).join(""));
+    const exact = ordered.find((family) => gpuKey(family) === key);
+    if (exact) return exact;
+  }
+  const key = gpuKey(query);
+  return ordered.find((family) => gpuKey(family).startsWith(key))
+    ?? [...ordered].sort((a, b) => gpuKey(b).length - gpuKey(a).length).find((family) => key.startsWith(gpuKey(family)))
+    ?? null;
+}
+
+/** The sentence for a name that matches no GPU, naming the ones that do. */
+export const gpuNoMatch = (query: string, families: readonly string[]) =>
+  `No GPU matches "${query.trim()}". GPUs: ${families.join(", ")}.`;
 export const gpuBasisLabel = (basis: GpuBasis, compact = false): string => compact
   ? ({ list: "List", spot: "Spot", ask: "Ask", reserved: "Rsvd", index: "Locked", reference: "Reference" })[basis]
   : ({ list: "List price", spot: "Provider-declared spot", ask: "Ask", reserved: "Reserved", index: "Index (licensed)", reference: "Reference" })[basis];
@@ -60,13 +97,31 @@ export function gpuTime(value: string | null | undefined, compact = false): stri
   return compact ? `${day} ${time}` : `${day}, ${date.getUTCFullYear()} ${time} UTC`;
 }
 
-export function gpuRows(rows: readonly GpuBoardRow[], model = "", basis = "all"): GpuBoardRow[] {
+export function gpuRows<T extends GpuBoardRow>(rows: readonly T[], model = "", basis = "all"): T[] {
   const rank = (row: GpuBoardRow) => row.providerClass === "aggregate" ? 0 : row.basis === "list" ? 1 : row.basis === "spot" ? 2 : row.basis === "reserved" ? 3 : 4;
-  return rows.filter((row) => (!model || row.gpuModel === model) && (basis === "all" || row.basis === basis)).sort((a, b) => {
-    const modelRank = (name: string) => GPU_MODELS.indexOf(name) < 0 ? 99 : GPU_MODELS.indexOf(name);
-    return modelRank(a.gpuModel) - modelRank(b.gpuModel) || a.gpuModel.localeCompare(b.gpuModel) || rank(a) - rank(b)
-      || gpuSource(a).localeCompare(gpuSource(b)) || (b.memoryGb ?? 0) - (a.memoryGb ?? 0) || (a.formFactor ?? "").localeCompare(b.formFactor ?? "");
-  });
+  return rows.filter((row) => (!model || row.gpuModel === model) && (basis === "all" || row.basis === basis)).sort((a, b) =>
+    gpuModelOrder(a.gpuModel, b.gpuModel) || rank(a) - rank(b)
+      || gpuSource(a).localeCompare(gpuSource(b)) || (b.memoryGb ?? 0) - (a.memoryGb ?? 0) || (a.formFactor ?? "").localeCompare(b.formFactor ?? ""));
+}
+
+/** A row the free board leaves out, read from the free preview of its GPU: the latest price, with its moves left to Pro. */
+export type GpuPreviewRow = GpuBoardRow & { changesLocked: true };
+export const gpuChangesLocked = (row: GpuBoardRow): row is GpuPreviewRow => (row as Partial<GpuPreviewRow>).changesLocked === true;
+
+/**
+ * The free board carries three rows of one GPU. For another GPU, the latest
+ * rows its free history preview serves stand in, one per series; reference
+ * indexes stay out, as they do on the board.
+ */
+export function gpuPreviewRows(points: readonly GpuObservation[]): GpuPreviewRow[] {
+  const latest = new Map<string, GpuObservation>();
+  for (const point of points) {
+    if (point.basis === "reference" || point.provenance === "reference" || point.basis === "index") continue;
+    const id = `${point.source}:${point.skuKey}`;
+    if (!latest.has(id) || point.observedAt > latest.get(id)!.observedAt) latest.set(id, point);
+  }
+  return [...latest].map(([id, point]) => ({ ...point, id, label: gpuLabel(point), sourceLabel: gpuSource(point),
+    change1d: null, change7d: null, change30d: null, stale: false, lastError: null, changesLocked: true }));
 }
 
 /** The bases in board order. The licensed index never reaches the board. */
@@ -105,9 +160,8 @@ export interface GpuBoardSection { id: string; label: string; basis: GpuBasis; g
  * sections by basis alone; every model names the model in each heading.
  */
 export function gpuBoardSections(rows: readonly GpuBoardRow[], model = ""): GpuBoardSection[] {
-  const modelRank = (name: string) => GPU_MODELS.indexOf(name) < 0 ? 99 : GPU_MODELS.indexOf(name);
   const ordered = rows.filter((row) => (!model || row.gpuModel === model) && row.basis !== "index").sort((a, b) =>
-    modelRank(a.gpuModel) - modelRank(b.gpuModel) || a.gpuModel.localeCompare(b.gpuModel) || basisRank(a.basis) - basisRank(b.basis)
+    gpuModelOrder(a.gpuModel, b.gpuModel) || basisRank(a.basis) - basisRank(b.basis)
     || Number(gpuHeadline(b)) - Number(gpuHeadline(a)) || gpuSource(a).localeCompare(gpuSource(b))
     || (b.memoryGb ?? 0) - (a.memoryGb ?? 0) || (a.formFactor ?? "").localeCompare(b.formFactor ?? ""));
   const sections: GpuBoardSection[] = [];
@@ -321,18 +375,49 @@ export const GPU_EQUITY_GROUPS = [
   { label: "Neoclouds", roles: ["Neocloud"] }, { label: "Hosts and builders", roles: ["Host", "Server builder"] },
 ] as const;
 
-export function gpuEquityRows(rows: readonly GpuBoardRow[], selectedModel: string) {
+const equityModel = (symbol: string, selectedModel: string) => symbol === "AMD" && !selectedModel.startsWith("MI") ? "MI300X"
+  : symbol === "NVDA" && selectedModel.startsWith("MI") ? "H100" : selectedModel;
+
+/** The GPUs the Equities tab reads for one selected GPU: AMD reads its own chip, NVIDIA reads H100 beside an AMD chip. */
+export const gpuEquityModels = (selectedModel: string) => [...new Set(GPU_EQUITIES.map(({ symbol }) => equityModel(symbol, selectedModel)))];
+
+/**
+ * Each share beside the list series that ties it to GPU rents. A share with
+ * no series says why: `pro` when the free board leaves its series out,
+ * `unlisted` when the board has no such series at all.
+ */
+export function gpuEquityRows(rows: readonly GpuBoardRow[], selectedModel: string, locked = false) {
   return GPU_EQUITIES.map((equity) => {
-    const model = equity.symbol === "AMD" && !selectedModel.startsWith("MI") ? "MI300X"
-      : equity.symbol === "NVDA" && selectedModel.startsWith("MI") ? "H100" : selectedModel;
+    const model = equityModel(equity.symbol, selectedModel);
     const candidates = gpuRows(rows, model, "list");
-    const aggregates = candidates.filter((row) => row.providerClass === "aggregate").sort((a, b) =>
-      Number(b.formFactor === "SXM") - Number(a.formFactor === "SXM") || (b.stats?.n ?? 0) - (a.stats?.n ?? 0) || (b.memoryGb ?? 0) - (a.memoryGb ?? 0));
-    const reference = "provider" in equity ? candidates.find((row) => gpuSource(row) === equity.provider)
-      : aggregates.find((row) => row.provider.startsWith("Neocloud")) ?? aggregates[0];
-    return { ...equity, gpuModel: model, reference: reference ?? null };
+    const reference = ("provider" in equity ? candidates.find((row) => gpuSource(row) === equity.provider) : gpuListIndex(candidates, model)) ?? null;
+    const gap: "pro" | "unlisted" | null = reference ? null : locked ? "pro" : "unlisted";
+    return { ...equity, gpuModel: model, reference, gap };
   });
 }
+export type GpuEquityRow = ReturnType<typeof gpuEquityRows>[number];
+
+/**
+ * A GPU's list index: of its main variant (SXM first, then the most
+ * providers, then the most memory), the neocloud index, else the hyperscaler
+ * one. The series a share reads in Equities, and the catalog's GPU list indexes.
+ */
+export function gpuListIndex<T extends GpuBoardRow>(rows: readonly T[], model: string): T | null {
+  const indexes = gpuRows(rows, model, "list").filter((row) => row.providerClass === "aggregate").sort((a, b) =>
+    Number(b.formFactor === "SXM") - Number(a.formFactor === "SXM") || (b.stats?.n ?? 0) - (a.stats?.n ?? 0) || (b.memoryGb ?? 0) - (a.memoryGb ?? 0));
+  return indexes.find((row) => row.provider.startsWith("Neocloud")) ?? indexes[0] ?? null;
+}
+
+/** The series a share would read, named when it has none: "AWS H100 list", "H100 list index". */
+const gpuEquitySeries = (row: Pick<GpuEquityRow, "gpuModel"> & { provider?: string }) =>
+  row.provider ? `${row.provider} ${row.gpuModel} list` : `${row.gpuModel} list index`;
+
+/**
+ * The series column of a share with no series: the one Pro unlocks (its price
+ * and move cells read Pro), or the one the board does not list.
+ */
+export const gpuEquityGap = (row: GpuEquityRow) => row.gap === "pro" ? gpuEquitySeries(row)
+  : row.gap === "unlisted" ? `No ${gpuEquitySeries(row)}` : null;
 
 export function equityFiveDayReturn(history: readonly PricePoint[]): { value: number | null; asOf: string | null } {
   const dates = new Map<string, { time: number; close: number }>();

package/src/plugins/builtin/gpu/pane.tsx

@@ -3,7 +3,7 @@ import { isAccessDenied } from "../../../api-client/errors";
 import { SignInWall } from "../cloud/auth-actions";
 import { CLOUD_PLAN_KEY, useCloudUpgradeAction } from "../shared/cloud-upgrade";
 import { isCloudSessionRequired, useResearchCloudSession } from "../shared/research-cloud-session";
-import { useCallback } from "react";
+import { useCallback, useMemo } from "react";
 import { PaneStatusBody, usePaneFooter, usePaneNoticeFooter, usePaneStatusFooter, usePaneTabs } from "../../../components";
 import { usePaneRefreshKey } from "../../../components/data-table/table-pane";
 import { useAsyncResource, useAutoRefresh, usePaneSettingValue, usePluginAppActions, usePluginPaneState } from "../../../public/react";
@@ -11,11 +11,11 @@ import { usePaneInstance } from "../../../state/app/context";
 import type { PaneProps } from "../../../types/plugin";
 import { Box } from "../../../ui";
 import { GpuBoard } from "./board";
-import { getCachedGpuBoard, gpuCacheScope, GPU_NOT_AVAILABLE, loadGpuBoard } from "./client";
+import { getCachedGpuBoard, gpuCacheScope, GPU_NOT_AVAILABLE, gpuPreviewModels, loadGpuBoard, loadGpuModelPreviews } from "./client";
 import { GpuChanges } from "./changes";
 import { GpuEquities } from "./equities";
 import { GpuHistory } from "./history";
-import { GPU_TABS, gpuTab, gpuTime } from "./model";
+import { GPU_TABS, gpuEquityModels, gpuFamilies, gpuFamily, gpuNoMatch, gpuTab, gpuTime } from "./model";
 
 export function GpuPane(props: PaneProps) {
   usePlanAccess();
@@ -34,12 +34,28 @@ function GpuView({ width, height, focused }: PaneProps) {
   const resource = useAsyncResource(loadGpuBoard, { initialData: getCachedGpuBoard, clearOnError: isAccessDenied });
   const data = resource.data?.payload;
   const { createPaneFromTemplate } = usePluginAppActions();
+  const locked = !!data?.access?.locked;
+  const families = useMemo(() => gpuFamilies(data?.rows ?? []), [data]);
+  // What was typed ("h-100", "H100 80GB SXM") reads as the GPU it names; a name that matches none stays as typed and says so.
+  const activeModel = model ? gpuFamily(model, families) ?? model : "";
+  const unknownModel = !!model && !families.includes(activeModel);
+  // The free board is one GPU's three rows; another GPU's free preview stands in for the rows it leaves out.
+  const previewKey = useMemo(() => data && !unknownModel ? gpuPreviewModels(data, tab === "equities" ? gpuEquityModels(activeModel || "H100")
+    : tab === "changes" ? [] : tab === "history" ? [activeModel || "H100"] : [activeModel]).join("\n") : "", [data, unknownModel, tab, activeModel]);
+  const previewLoader = useCallback((force: boolean) => loadGpuModelPreviews(previewKey.split("\n"), force), [previewKey]);
+  const preview = useAsyncResource(previewKey ? previewLoader : null);
+  const rows = useMemo(() => data ? [...data.rows, ...(previewKey ? preview.data ?? [] : [])] : [], [data, previewKey, preview.data]);
+  const models = useMemo(() => locked ? [...families].sort() : [...new Set(rows.map((row) => row.gpuModel))].sort(), [locked, families, rows]);
+  // A failed preview is the footer's error; the body does not repeat it.
+  const emptyTitle = unknownModel ? gpuNoMatch(model, families)
+    : preview.error ? `No ${activeModel} rental prices to show.` : `No ${activeModel} rental prices have been observed yet.`;
   useAutoRefresh(resource.updatedAt, resource.load);
-  usePaneRefreshKey(() => void resource.reload(), { focused: focused && (tab === "board" || !data) });
+  useAutoRefresh(preview.updatedAt, preview.load);
+  usePaneRefreshKey(() => { void resource.reload(); void preview.reload(); }, { focused: focused && (tab === "board" || !data) });
   const signIn = !data && (session.needsVerification || isCloudSessionRequired(resource.error));
   const notAvailable = !data && resource.error === GPU_NOT_AVAILABLE;
-  usePaneStatusFooter({ registrationId: "gpu", loading: resource.loading, error: notAvailable || signIn ? null : resource.error,
-    stale: !!data && (data.stale || resource.data?.stale), info: data?.asOf ? [{ id: "asof", parts: [{ text: `as of ${gpuTime(data.asOf)}`, tone: "muted" }] }] : [] });
+  usePaneStatusFooter({ registrationId: "gpu", loading: resource.loading || preview.loading, error: notAvailable || signIn ? null : resource.error ?? preview.error,
+    stale: !!data && (data.stale || resource.data?.stale), info: data?.asOf ? [{ id: "asof", asOf: true, parts: [{ text: `as of ${gpuTime(data.asOf)}`, tone: "muted" }] }] : [] });
   usePaneNoticeFooter({ registrationId: "gpu:notices", focused,
     notices: [...(data?.gaps ?? []), ...(resource.data?.refreshError ? [resource.data.refreshError] : [])] });
   usePaneFooter("gpu:actions", () => ({ info: data?.access?.preview ? [{ id: "preview", parts: [{ text: "Free preview", tone: "muted" }] }] : [],
@@ -47,17 +63,17 @@ function GpuView({ width, height, focused }: PaneProps) {
     onPress: () => createPaneFromTemplate("buildout-pane") }] }), [createPaneFromTemplate, data?.access, upgrade]);
   const { strip, rows: tabRows } = usePaneTabs(data ? { tabs: [...GPU_TABS], activeValue: tab, onSelect: setTab, focused, dense: true } : null);
   const body = { width, height: Math.max(3, height - tabRows), focused };
-  const reloadBoard = useCallback(() => { void resource.reload(); }, [resource.reload]);
+  const reloadBoard = useCallback(() => { void resource.reload(); void preview.reload(); }, [resource.reload, preview.reload]);
   if (signIn) return <SignInWall placement="gpu" width={width} height={height} action="browse GPU rental prices" needsVerification={session.needsVerification} />;
   return <Box width={width} height={height} flexDirection="column">
     {strip}
-    <PaneStatusBody loading={resource.loading && !data} error={!data && !notAvailable ? resource.error : null}
+    <PaneStatusBody loading={(resource.loading && !data) || (!!previewKey && preview.loading && !preview.data)} error={!data && !notAvailable ? resource.error : null}
       empty={notAvailable} emptyTitle={GPU_NOT_AVAILABLE} subject="GPU rental prices">
-      {data ? tab === "board" ? <GpuBoard rows={data.rows} asOf={data.asOf} model={model} setModel={setModel} selectedId={selectedId}
+      {data ? tab === "board" ? <GpuBoard rows={rows} models={models} asOf={data.asOf} model={activeModel} setModel={setModel} selectedId={selectedId} emptyTitle={emptyTitle}
         select={(row, open) => { setSelectedId(row.id); if (open) setTab("history"); }} {...body} />
-        : tab === "history" ? <GpuHistory rows={data.rows} model={model} setModel={setModel} selectedId={selectedId} onSelect={setSelectedId} reloadBoard={reloadBoard} {...body} />
-          : tab === "changes" ? <GpuChanges board={data.rows} model={model} setModel={setModel} reloadBoard={reloadBoard} {...body} />
-            : <GpuEquities board={data.rows} model={model} setModel={setModel} reloadBoard={reloadBoard} {...body} /> : null}
+        : tab === "history" ? <GpuHistory rows={rows} models={models} model={unknownModel ? "" : activeModel} setModel={setModel} selectedId={selectedId} onSelect={setSelectedId} reloadBoard={reloadBoard} {...body} />
+          : tab === "changes" ? <GpuChanges models={models} model={unknownModel ? "" : activeModel} setModel={setModel} reloadBoard={reloadBoard} {...body} />
+            : <GpuEquities board={rows} models={models} locked={locked} model={unknownModel ? "" : activeModel} setModel={setModel} reloadBoard={reloadBoard} {...body} /> : null}
     </PaneStatusBody>
   </Box>;
 }

package/src/plugins/builtin/gpu/series.ts

@@ -0,0 +1,38 @@
+import type { SeriesDefinition } from "../../../series/types";
+import { cachedSeriesWarning } from "../shared/series-warning";
+import { loadGpuBoard, loadGpuHistory } from "./client";
+import { GPU_MODELS, gpuListIndex } from "./model";
+
+/** What the GPU pane says when the free preview leaves history out. */
+const GPU_PRO_ONLY = "Full history is available with Pro.";
+
+/**
+ * Each GPU's list index, the one the GPU pane's Equities tab reads shares
+ * against. The per-provider listings stay on the board and its History tab:
+ * the server lists them, and they come and go.
+ */
+export const GPU_SERIES: readonly SeriesDefinition[] = GPU_MODELS.map((model): SeriesDefinition => ({
+  id: `gpu:${model.toLowerCase().replaceAll(" ", "-")}-list-index`,
+  name: `${model} rental list index`,
+  unit: "USD/GPU-hour",
+  frequency: "intraday",
+  group: "Alternative data",
+  tags: ["GPU", "rental", "compute", "cloud", "list price", model],
+  description: `Median list price to rent one ${model} from neocloud providers (hyperscalers where none list it), chained so a change of providers causes no jump, as GPU charts it. Needs Pro.`,
+  style: "step",
+  load: async () => {
+    const board = await loadGpuBoard();
+    if (board.payload.access?.locked) throw new Error(GPU_PRO_ONLY);
+    const index = gpuListIndex(board.payload.rows, model);
+    if (!index) throw new Error(`No ${model} list index is listed yet.`);
+    const history = await loadGpuHistory(index.id);
+    if (history.payload.access?.locked) throw new Error(GPU_PRO_ONLY);
+    const warning = cachedSeriesWarning(history);
+    return {
+      points: history.payload.points
+        .filter((point) => `${point.source}:${point.skuKey}` === index.id)
+        .map((point) => ({ date: point.observedAt, value: point.pricePerGpuHr })),
+      ...(warning ? { warning } : {}),
+    };
+  },
+}));

package/src/plugins/builtin/help/function-card.tsx

@@ -2,8 +2,10 @@
  * The help card for one function, opened by `HELP <fn>` in the command bar
  * and F1 on a focused pane: what it answers, how to type it, the keys that
  * matter in its pane, how fresh its data is on each plan, its Bloomberg
- * equivalent and its docs entry. Enter or the link opens the docs; Esc, the
- * close button or a click outside closes it.
+ * equivalent and its docs entry. Enter reads the entry in DOCS, inside the
+ * app; the link beside it is the same entry on gloom.sh, in the browser. A
+ * popped-out window cannot open a pane, so there Enter opens the link. Esc,
+ * the close button or a click outside closes it.
  *
  * `useFunctionHelpHost` is mounted with the app's global shortcuts for the
  * life of the window and owns the dialog; `requestFunctionHelp` lets the
@@ -13,7 +15,9 @@ import { useEffect, useRef, type ReactNode } from "react";
 import { usePlanAccess } from "../../../api-client/plan-access";
 import { functionDocsUrl, type FunctionFreshness, type FunctionHelpKey } from "../../../cli/pane-functions/function-help";
 import { requestFeedbackDialog } from "../../../components/feedback-dialog";
+import { Button } from "../../../components/ui/button";
 import { ExternalLink } from "../../../components/ui/external-link";
+import { DOCS_PANE_TEMPLATE_ID } from "../../../docs/content";
 import { DialogFrame } from "../../../components/ui/frame";
 import { ShortcutHint } from "../../../components/ui/shortcut-hint";
 import { t } from "../../../i18n";
@@ -21,10 +25,12 @@ import { useViewport } from "../../../react/input";
 import { useThemeColors } from "../../../theme/theme-context";
 import { Box, Text, TextAttributes, useRendererHost } from "../../../ui";
 import { useDialog, useDialogKeyboard, type AlertContext } from "../../../ui/dialog";
+import { getSharedRegistry } from "../../registry";
 import type { HelpFunction } from "./function-index";
 
 export type FunctionHelpRequest =
-  | { kind: "function"; fn: HelpFunction }
+  /** `inAppDocs: false` where DOCS cannot open (a popped-out window). */
+  | { kind: "function"; fn: HelpFunction; inAppDocs?: boolean }
   /** `HELP HELP`: the feedback dialog, which is how people reach us. */
   | { kind: "support" };
 
@@ -103,9 +109,10 @@ function FreshnessRows({ data, pro }: { data: FunctionFreshness; pro: boolean })
   );
 }
 
-function FunctionHelpCard({ fn, dismiss, dialogId, width, compact = false }: AlertContext & {
+function FunctionHelpCard({ fn, dismiss, dialogId, width, compact = false, inAppDocs = true }: AlertContext & {
   fn: HelpFunction;
   width: number;
+  inAppDocs?: boolean;
   /** A short terminal: no blank row between the summary and the rows. */
   compact?: boolean;
 }) {
@@ -117,6 +124,10 @@ function FunctionHelpCard({ fn, dismiss, dialogId, width, compact = false }: Ale
     void rendererHost.openExternal(url);
     dismiss();
   };
+  const readInApp = () => {
+    getSharedRegistry()?.createPaneFromTemplate(DOCS_PANE_TEMPLATE_ID, { arg: fn.code });
+    dismiss();
+  };
 
   useDialogKeyboard((event) => {
     if (event.ctrl || event.alt || event.meta || event.super) return;
@@ -124,7 +135,8 @@ function FunctionHelpCard({ fn, dismiss, dialogId, width, compact = false }: Ale
     if (name !== "enter" && name !== "return") return;
     event.preventDefault();
     event.stopPropagation();
-    openDocs();
+    if (inAppDocs) readInApp();
+    else openDocs();
   }, { scope: dialogId });
 
   const help = fn.help;
@@ -153,6 +165,11 @@ function FunctionHelpCard({ fn, dismiss, dialogId, width, compact = false }: Ale
             </CardRow>
           )}
           <CardRow label="Docs">
+            {inAppDocs && (
+              <Box flexDirection="row">
+                <Button label="Read in Docs" shortcut="Enter" compact onPress={readInApp} stopPropagation />
+              </Box>
+            )}
             <ExternalLink url={docsUrl} label={docsUrl.replace(/^https:\/\//, "")} onOpen={openDocs} />
           </CardRow>
         </Box>
@@ -189,7 +206,9 @@ export function useFunctionHelpHost({ closeCommandBar }: { closeCommandBar: () =
         closeOnClickOutside: true,
         // The terminal host defaults to 60 columns; the desktop sizes to the content.
         style: { width: width + TERMINAL_DIALOG_CHROME, ...(compact ? { paddingY: 0 } : {}) },
-        content: (context: AlertContext) => <FunctionHelpCard {...context} fn={request.fn} width={width} compact={compact} />,
+        content: (context: AlertContext) => (
+          <FunctionHelpCard {...context} fn={request.fn} width={width} compact={compact} inAppDocs={request.inAppDocs !== false} />
+        ),
       }).catch(() => {}).finally(() => {
         openRef.current = false;
       });

package/src/plugins/builtin/help/function-index.ts

@@ -61,6 +61,8 @@ function withHelp(fn: Omit<HelpFunction, "help">): HelpFunction {
 export function buildHelpFunctionIndex(sources: HelpFunctionSources): HelpFunctionIndex {
   const functions: HelpFunction[] = [];
   for (const command of sources.commands ?? builtInCommands) {
+    // Search phrases on an action without a mnemonic are not standalone functions.
+    if (!command.prefix.trim()) continue;
     const [code, ...aliases] = getCommandPrefixes(command);
     if (!code) continue;
     functions.push(withHelp({

package/src/plugins/builtin/help/index.tsx

@@ -8,10 +8,11 @@ import { Box, ScrollBox, Text, useRendererHost, useUiHost } from "../../../ui";
 import { detectShortcutPlatform, formatPrimaryShortcut, getShortcutDisplayMode } from "../../../utils/shortcut-labels";
 import { getSharedRegistry } from "../../registry";
 import { apiClient, type CloudPricing } from "../../../api-client";
-import { trialDaysOf } from "../account-management/model";
+import { trialDaysOf } from "../../../account/billing";
 import { usePluginAppActions, usePluginPaneState } from "../../runtime";
 import type { PluginModule } from "../plugin-module";
 import { requestFeedbackDialog } from "../../../components/feedback-dialog";
+import { DOCS_PANE_TEMPLATE_ID } from "../../../docs/content";
 import { FeedbackTab } from "./feedback-tab";
 import { FunctionsTable } from "./functions-table";
 import { KeybindingsEditor } from "./keybindings-editor";
@@ -36,7 +37,7 @@ function entry(id: string, badges: string[], description: string): ShortcutTable
 
 function HelpPane({ focused, width, height }: PaneProps) {
   const registry = getSharedRegistry();
-  const { openCommandBar, showPane } = usePluginAppActions();
+  const { openCommandBar, showPane, createPaneFromTemplate } = usePluginAppActions();
   // A key capture requested from the command bar belongs to the Shortcuts
   // tab, whether the pane is already open or is being opened for it.
   const [activeTabId, setActiveTabId] = usePluginPaneState<HelpTabId>("activeTab", "basics");
@@ -56,6 +57,7 @@ function HelpPane({ focused, width, height }: PaneProps) {
   const windowMoveBadges = actionBadges("window-move-mode");
   const windowResizeBadges = actionBadges("window-resize-mode");
   const functionHelpBadges = actionBadges("function-help");
+  const askBadges = actionBadges("pane-ask");
   useEffect(() => subscribeKeybindingCapture(() => setActiveTabId("shortcuts")), []);
   const copyBadges = shortcutDisplayMode === "terminal" ? ["Ctrl+Shift+C"] : [platformShortcut("C")];
   const pasteBadges = shortcutDisplayMode === "terminal" ? ["Ctrl+Shift+V"] : [platformShortcut("V")];
@@ -100,6 +102,10 @@ function HelpPane({ focused, width, height }: PaneProps) {
     openCommandBar("PL ");
   }, [openCommandBar]);
 
+  const openDocs = useCallback(() => {
+    createPaneFromTemplate(DOCS_PANE_TEMPLATE_ID);
+  }, [createPaneFromTemplate]);
+
   const openIssues = useCallback(() => {
     void rendererHost.openExternal(GLOOMBERB_ISSUES_URL);
   }, [rendererHost]);
@@ -107,7 +113,10 @@ function HelpPane({ focused, width, height }: PaneProps) {
   // Each tab's actions. `l` moves between tabs, so layout actions take `a`.
   const tabHints = useMemo<PaneHint[]>(() => {
     if (activeTabId === "basics") {
-      return [{ id: "layout-actions", key: "a", label: " layout actions", title: "Layout Actions", onPress: openLayoutActions }];
+      return [
+        { id: "docs", key: "d", label: "ocs", title: "Open Docs", onPress: openDocs },
+        { id: "layout-actions", key: "a", label: " layout actions", title: "Layout Actions", onPress: openLayoutActions },
+      ];
     }
     if (activeTabId === "functions") {
       return [{ id: "plugins", key: "p", label: "lugins", title: "Manage Plugins", onPress: openPluginManager }];
@@ -120,7 +129,7 @@ function HelpPane({ focused, width, height }: PaneProps) {
       ];
     }
     return [];
-  }, [activeTabId, openDebugLog, openIssues, openLayoutActions, openPluginManager]);
+  }, [activeTabId, openDebugLog, openDocs, openIssues, openLayoutActions, openPluginManager]);
 
   // The footer binds each hint's key; a search field keeps its typing.
   usePaneFooter("help:tab", () => tabHints.length > 0 ? { hints: tabHints } : null, [tabHints]);
@@ -152,6 +161,7 @@ function HelpPane({ focused, width, height }: PaneProps) {
         : []),
       entry("des", ["DES", "<ticker>"], "Open security details for a specific ticker."),
       entry("help-card", ["HELP", "<function>"], "Open a function's help card: what it shows, its keys, how fresh its data is. HELP HELP reaches support."),
+      entry("docs", ["DOCS", "<function>"], "Read the docs and Academy lessons in the app. The ? on a pane opens its entry."),
       entry("upgrade", ["UPGRADE"], tf("Go Pro for real-time data at gloom.sh/cloud, free for {days} days.", { days: trialDays })),
       entry("mcp", ["MCP"], "Connect Claude Code, Codex, Cursor or any MCP client to Gloom's research tools."),
       entry("move", ["Up/Down", "Ctrl+P/N"], "Move through command bar results."),
@@ -175,9 +185,13 @@ function HelpPane({ focused, width, height }: PaneProps) {
         entry("back", ["Esc", "Backspace"], "Go back from a detail view."),
         entry("pane-menu", actionBadges("pane-menu"), "Open the focused pane's menu: every action in the pane with its key, sorting, filters, tabs, toggles and the pane actions."),
         ...(functionHelpBadges.length > 0
-          ? [entry("function-help", functionHelpBadges, "Open the focused pane's help card, with a link to its docs.")]
+          ? [entry("function-help", functionHelpBadges, "Open the focused pane's help card; Enter reads its docs.")]
+          : []),
+        ...(askBadges.length > 0
+          ? [entry("ask-gloom", askBadges, "Ask Gloom about the focused pane, in a new conversation with the pane attached. Also Ask Gloom in the pane menu.")]
           : []),
         entry("search", ["/"], "Search in the focused pane."),
+        entry("sidebar", ["<", ">"], "Narrow or widen the list beside the content, as in MAP and ASKG."),
         entry("warnings", ["!"], "Open the focused pane's data warnings."),
         entry("notification", [...actionBadges("notification-action"), ...actionBadges("notification-dismiss")], "Run or dismiss the newest notification."),
       ],
@@ -215,6 +229,14 @@ function HelpPane({ focused, width, height }: PaneProps) {
         entry("zoom-keys", ["+/-", "0"], "Zoom the focused chart in or out, or reset it."),
       ],
     },
+    {
+      label: "Map",
+      items: [
+        entry("map-pan", ["m", "Arrows"], "Give the arrow keys to the map and pan it; Shift pans further, Esc gives them back to the list."),
+        entry("map-zoom", ["+/-", "0"], "Zoom the map in or out, or reset it."),
+        entry("map-pointer", ["Scroll", "Pinch"], "Zoom the map around the pointer; drag to pan, double-click to zoom in."),
+      ],
+    },
     {
       label: "Clipboard",
       items: [
@@ -246,7 +268,7 @@ function HelpPane({ focused, width, height }: PaneProps) {
         entry("commit", ["Enter", "Esc"], "Commit pending changes or exit window mode."),
       ],
     },
-  ], [copyBadges, functionHelpBadges, pasteBadges, windowMoveBadges, windowResizeBadges]);
+  ], [askBadges, copyBadges, functionHelpBadges, pasteBadges, windowMoveBadges, windowResizeBadges]);
 
   const renderContent = () => {
     switch (activeTabId) {
@@ -267,11 +289,11 @@ function HelpPane({ focused, width, height }: PaneProps) {
               <SectionHeading title="How To Use Gloomberb" />
               <Box flexDirection="column">
                 <Text fg={colors.textDim}>{t("Gloomberb is command-bar first.")}</Text>
-                <Text fg={colors.textDim}>{t("Use the keyboard for speed, and the mouse for windows.")}</Text>
+                <Text fg={colors.textDim} wrapText>{t("Click anything to use it; the keys shown beside actions are shortcuts.")}</Text>
                 <Text fg={colors.textDim} wrapText>
                   {commandBarBadges[0]
-                    ? tf("Not sure of a code? Press {key} and type what you want in plain words, like \"apple earnings\". The Functions tab lists everything.", { key: commandBarBadges[0] })
-                    : t("Not sure of a code? Type what you want in plain words, like \"apple earnings\". The Functions tab lists everything.")}
+                    ? tf("Not sure of a code? Click the search bar at the top, or press {key}, and type what you want in plain words, like \"apple earnings\". The Functions tab lists everything.", { key: commandBarBadges[0] })
+                    : t("Not sure of a code? Click the search bar at the top and type what you want in plain words, like \"apple earnings\". The Functions tab lists everything.")}
                 </Text>
               </Box>
             </Box>