gloomberb 0.17.0 → 0.17.1

package/src/cli/index.ts

@@ -37,7 +37,7 @@ import { createSystemCliCommands } from "./commands/system";
 import { brokerCliCommand, ibkrCliCommand } from "./commands/broker";
 import { listPlugins, updatePlugins } from "./commands/plugins";
 import { installListedPlugin, removePlugin } from "../plugins/installer";
-import { runPaneCatalog, runPaneFunction, runPaneScreenshot } from "./pane-functions";
+import { functionCodeCommand, runPaneCatalog, runPaneFunction, runPaneScreenshot } from "./pane-functions";
 import { catalogFredSeriesIds } from "./series-search";
 
 const { width: SHOT_WIDTH, height: SHOT_HEIGHT } = SHOT_SIZE_LIMITS;
@@ -60,11 +60,11 @@ function createCoreCliCommands(
         usage: ["help [command]", "<command> --help"],
         examples: ["help", "help quote", "quote --help"],
       },
-      execute: (args, ctx) => {
+      execute: async (args, ctx) => {
         const topic = args[0];
         if (topic) {
           const command = lookupCommand(topic);
-          if (!command) failUnknownCommand(topic, allCommands());
+          if (!command) failUnknownCommand(topic, allCommands(), await functionCodeCommand(ctx, topic, []));
           printCommandHelp(command, ctx);
           return;
         }
@@ -306,7 +306,9 @@ function printCommandHelp(command: CliCommandDef, ctx: CliCommandContext): void
   ctx.printResult({ data: { ...describeCliCommand(command), sections: command.help?.sections ?? [] } });
 }
 
-function failUnknownCommand(token: string, commands: CliCommandDef[]): never {
+/** `function` is what the word is when it is a function's code, and the command that runs it. */
+function failUnknownCommand(token: string, commands: CliCommandDef[], fn: { code: string; command: string } | null = null): never {
+  if (fn) fail(`${fn.code} is a function: ${fn.command}`);
   const suggestion = suggestCliCommand(
     normalizeCliCommandToken(token),
     commands.flatMap((command) => [command.name, ...(command.aliases ?? [])]),
@@ -397,14 +399,20 @@ export async function dispatchCli(args: string[], options: DispatchCliOptions =
 /** Explains why dispatch found no command in `args`, suggesting the closest one. */
 export async function failUnknownCliCommand(args: string[], options: DispatchCliOptions = {}): Promise<never> {
   let token = args[0] ?? "";
+  let parsed: ReturnType<typeof parseCliGlobalArgs> | null = null;
   try {
     // Global flags may come first, so name the token dispatch actually looked up.
-    token = parseCliGlobalArgs(args).args[0] ?? token;
+    parsed = parseCliGlobalArgs(args);
+    token = parsed.args[0] ?? token;
   } catch {
     // dispatchCli already reported flags that do not parse.
   }
   const registry = await createRegistry(options);
-  return failUnknownCommand(token, listedCommands(registry).map((entry) => entry.command));
+  // A function's code typed as a command is pointed at `fn`, with the arguments the reader gave.
+  const fn = token && parsed
+    ? await functionCodeCommand(createCliCommandContext("core", registry, parsed.options, parsed.args.slice(1)), token, parsed.args.slice(1))
+    : null;
+  return failUnknownCommand(token, listedCommands(registry).map((entry) => entry.command), fn);
 }
 
 export async function runCli(args: string[], options: DispatchCliOptions = {}): Promise<boolean> {

package/src/cli/pane-functions/catalog.ts

@@ -115,6 +115,43 @@ export function buildPaneFunctionLookup(registry: PaneFunctionCatalog): Map<stri
   return lookup;
 }
 
+/** What a function takes after its code, as the catalog writes it: `<ticker>`, `<fund, ticker, or CIK>`, or nothing. */
+function argumentHint({ argKind, argPlaceholder }: Pick<PaneCatalogEntry, "argKind" | "argPlaceholder">): string {
+  if (argPlaceholder) return `<${argPlaceholder}>`;
+  return argKind && argKind !== "none" ? `<${argKind}>` : "";
+}
+
+/** A command-line token that is the code or an alias of a function, with what the function takes. */
+export interface FunctionCode {
+  argument: string;
+}
+
+/**
+ * Whether `token` is the code or an alias of a function (`OVDV`, `EEO`), in any
+ * case: the function `fn` opens for it, not one it merely matches by a keyword
+ * or a label.
+ */
+export function findFunctionCode(registry: PaneFunctionCatalog, token: string): FunctionCode | null {
+  const wanted = normalizeLookupToken(token);
+  const found = wanted ? buildPaneFunctionLookup(registry).get(wanted) : undefined;
+  if (!found || !("paneId" in found && "description" in found)) return null;
+  const pane = registry.panes.get(found.paneId);
+  const headless = pane ? getHeadlessPaneDefinition(found, pane) : undefined;
+  const codes = [
+    found.shortcut?.prefix,
+    ...(found.shortcut?.aliases ?? []),
+    headless?.discovery?.id,
+    ...(headless?.discovery?.aliases ?? []),
+  ];
+  if (!codes.some((code) => code && normalizeLookupToken(code) === wanted)) return null;
+  return {
+    argument: argumentHint({
+      argKind: headless?.argument.kind ?? found.shortcut?.argKind,
+      argPlaceholder: headless?.argument.placeholder ?? found.shortcut?.argPlaceholder,
+    }),
+  };
+}
+
 function sampleArgForTemplate(template: PaneTemplateDef): string {
   switch (template.shortcut?.argKind) {
     case "ticker":
@@ -438,11 +475,6 @@ function readinessCell(readiness: PaneFunctionReadiness): string {
   return cliStyles.muted(label);
 }
 
-function catalogArgument(entry: PaneCatalogEntry): string {
-  if (entry.argPlaceholder) return `<${entry.argPlaceholder}>`;
-  return entry.argKind && entry.argKind !== "none" ? `<${entry.argKind}>` : "";
-}
-
 // Choices longer than this move from the flag into its description, where they can wrap.
 const MAX_INLINE_CHOICES = 24;
 
@@ -473,7 +505,7 @@ export function limitationSentence(text: string): string {
 function renderCatalogEntry(entry: PaneCatalogEntry): string {
   const width = Math.min(cliTerminalWidth() ?? CATALOG_TEXT_WIDTH, CATALOG_TEXT_WIDTH);
   const capability = entry.capability;
-  const argument = catalogArgument(entry);
+  const argument = argumentHint(entry);
   const invocation = `${entry.token}${argument ? ` ${argument}` : ""}`;
   const lines = [
     `${cliStyles.accent(entry.token)}  ${cliStyles.bold(entry.label)}`,
@@ -586,7 +618,7 @@ export function renderPaneCatalogReport(
       shown.map((entry) => [
         cliStyles.command(entry.token),
         entry.label,
-        catalogArgument(entry),
+        argumentHint(entry),
         readinessCell(entry.capability.reportReadiness),
         entry.description,
       ]),

package/src/cli/pane-functions/dom.ts

@@ -1,10 +1,12 @@
 import type { DesktopPaneShotRenderedRow } from "../desktop-pane-shot";
-import { cliStyles, cliTerminalWidth, renderSection, renderTable, wrapText } from "../../utils/cli-output";
+import { cliStyles, renderSection, renderTable } from "../../utils/cli-output";
 import { formatUtcTime } from "../../utils/utc-time";
 import type { MarketContext } from "../types";
 import type { PaneFunctionReport } from "./report";
 import type { ResolvedPaneFunction } from "./resolver";
 import { collectShotSymbols } from "./data";
+import { lockNoteLines } from "./lock-note";
+import { lockNoteReason } from "../../plugins/builtin/shared/pro-lock-note";
 import { renderDesktopShot, type PaneScreenshotResult } from "./screenshot";
 import { deriveRenderedFreshness, formatFreshnessLine, type ReportFreshness } from "./freshness";
 import { exportTextTable, reportFooterLines, type CliReportTables } from "../report-tables";
@@ -14,21 +16,24 @@ const DOM_REPORT_WIDTH = 1280;
 const DOM_REPORT_HEIGHT = 720;
 const DOM_LIMITATION =
   "Only values visible in the rendered pane are returned; clipped or off-screen data may be omitted.";
-/** The widest a lock note wraps to, as the catalog's text. */
-const LOCK_NOTE_WIDTH = 100;
 const DOM_EVERY_ROW =
   "Every row of the pane's table is returned, including rows scrolled out of view.";
 
 /** The sign-in wall's buttons, which a rendered view reads as words: `Log in ↵ Sign up free`. */
 const SIGN_IN_WALL_BUTTONS = /\s*\b(?:Log in|Sign up free|Resend Verification Email)(?:\s*\u21B5)?(?=\s|$)/g;
 
+/** Whether the wall asks for the account's email to be verified, not for a sign-in. */
+function asksToVerifyEmail(visibleText: string): boolean {
+  return /\bVerify your email\b/i.test(visibleText);
+}
+
 /**
  * A pane behind the sign-in wall, as a report reads it: the wall's headline
  * without its buttons, and what it needs in place of them.
  */
 function signInWallText(visibleText: string): string {
   const headline = visibleText.replace(SIGN_IN_WALL_BUTTONS, "").trim();
-  const needs = /\bVerify your email\b/i.test(visibleText)
+  const needs = asksToVerifyEmail(visibleText)
     ? "Requires a verified email on your Gloom account; resend the verification email in the app."
     : "Requires a free Gloom sign-in: log in or sign up in the app.";
   return headline ? `${headline} ${needs}` : needs;
@@ -195,14 +200,20 @@ export function buildDomPaneReportFromRender(
   // A wall in place of the whole pane: nothing was read, so the report says
   // what is locked and how to reach it, and cites no source.
   const gate = !hasStructuredRows ? result.render.accessGate ?? null : null;
-  const lockNote = gate ? resolved.pane.reportLockNote?.({ gate, symbol: result.symbols[0] ?? null }) ?? null : null;
+  const lockNote = gate
+    ? resolved.pane.reportLockNote?.({
+      gate,
+      symbol: result.symbols[0] ?? null,
+      token: resolved.token,
+      ...gate === "sign-in" && asksToVerifyEmail(result.render.visibleText ?? "") ? { verifyEmail: true } : {},
+    }) ?? null
+    : null;
   const locked = gate === "sign-in" || lockNote ? gate : null;
-  // JSON and CSV say why the report is empty in the note's words, on one line.
-  const lockReason = lockNote?.replace(/\s*\n\s*/g, " ") ?? null;
+  const lockReason = lockNote ? lockNoteReason(lockNote) : null;
   if (hasStructuredRows) {
     textLines.push(...renderDomTables(rows));
   } else if (lockNote) {
-    textLines.push(...wrapText(lockNote, Math.min(cliTerminalWidth() ?? LOCK_NOTE_WIDTH, LOCK_NOTE_WIDTH)));
+    textLines.push(...lockNoteLines(lockNote));
   } else if (result.render.visibleText) {
     textLines.push(gate === "sign-in" ? signInWallText(result.render.visibleText) : result.render.visibleText);
   } else {

package/src/cli/pane-functions/function-help.ts

@@ -264,8 +264,10 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
   },
   OSA: {
     summary: "Build a multi-leg options position and value it at any spot, date and vol shift: payoff, P&L grid, breakevens and Greeks. European pricing, so no early exercise. "
-      + "With a NAV and a budget in bps it sizes the position as a hedge: contracts, premium, notional protected and coverage of an equity sleeve.",
+      + "With a NAV and a budget in bps it sizes the position as a hedge: contracts, premium, notional protected and coverage of an equity sleeve. "
+      + "--strategy csp sells a cash-secured put: cash secured, premium, yield on cash and annualised, distance out of the money, break-even, days to expiry and an earnings flag.",
     usage: ["OSA AAPL", "gloomberb fn OSA AAPL --strategy vertical --expiration 2027-01-15",
+      "gloomberb fn OSA KO --strategy csp --strike 85 --expiration 2026-11-20",
       "gloomberb fn OSA SPY --strategy put --strike 700 --expiration 2027-01-15 --nav 100m --budget-bps 50 --sleeve 100m"],
     keys: [key("a", "dd leg"), key("c", "hain"), key("d", "ate"), key("v", "ol shift")],
     data: OPTIONS,

package/src/cli/pane-functions/headless.ts

@@ -40,6 +40,7 @@ import { isRecord } from "../../utils/guards";
 import { formatUtcTime, localTimeSuffix } from "../../utils/utc-time";
 import { deriveHeadlessFreshness, formatFreshnessLine, staleRowsText, type ReportFreshness } from "./freshness";
 import { accessGateStatus, errorsAccessGate, isProLock } from "./access-gate";
+import { lockedHeadlessReport } from "./lock-note";
 
 interface SerializableHeadlessColumn {
   key: string;
@@ -721,7 +722,17 @@ export async function buildHeadlessFunctionReport(
   context: MarketContext,
   rawArgument: string,
 ): Promise<PaneFunctionReport> {
-  const loaded = await loadResolvedHeadlessPaneModel(resolved, context, rawArgument);
+  let loaded: LoadedHeadlessPaneModel;
+  try {
+    loaded = await loadResolvedHeadlessPaneModel(resolved, context, rawArgument);
+  } catch (error) {
+    // A Pro pane the server refused reports what its wall covers, as its rendered view does.
+    const locked = lockedHeadlessReport(resolved, error, () => (
+      buildHeadlessPaneLoadArgs(resolved.headless!, resolved.token, rawArgument, resolved.options).symbols
+    ));
+    if (locked) return locked;
+    throw error;
+  }
   const { complete, unavailableSymbols, rowCount, symbols } = reportCoverage(loaded);
   const serialized = serializeHeadlessPaneResult(loaded.definition, loaded.result);
   const freshness = deriveHeadlessFreshness(loaded.definition, loaded.result);

package/src/cli/pane-functions/index.ts

@@ -5,6 +5,7 @@ import { withMarketData } from "../context";
 import { cliStyles, renderStats, type CliStatEntry } from "../../utils/cli-output";
 import {
   filterPaneCatalogEntries,
+  findFunctionCode,
   renderPaneCatalogReport,
   selectPaneCatalogMatches,
   type PaneFunctionCatalog,
@@ -63,6 +64,44 @@ async function withPaneRuntime<T>(
   });
 }
 
+/** A word that can be a function code: letters and digits, with the dots and dashes some codes carry. */
+const FUNCTION_CODE_WORD = /^[\w.$-]{1,24}$/;
+
+/** An argument as a shell reads it back: bare when it is one word, in quotes when it is not. */
+function commandWord(argument: string): string {
+  return /^[\w.:,=%+@/-]+$/.test(argument) ? argument : JSON.stringify(argument);
+}
+
+/**
+ * What to run when a command name is a function's code (`gloomberb OVDV KO`,
+ * `gloomberb help OVDV`): `fn` with the reader's own arguments, or the
+ * function's argument hint when they gave none. Null when the word is no
+ * function code or the catalog cannot be read, and the command stays unknown.
+ */
+export async function functionCodeCommand(
+  ctx: CliCommandContext,
+  token: string,
+  args: readonly string[],
+): Promise<{ code: string; command: string } | null> {
+  const word = token.trim();
+  if (!FUNCTION_CODE_WORD.test(word)) return null;
+  try {
+    const found = await withMarketData(ctx, async (market) => {
+      const registry = await createPaneCatalog(market, ctx.plugins);
+      try {
+        return findFunctionCode(registry, word);
+      } finally {
+        registry.destroy();
+      }
+    });
+    if (!found) return null;
+    const code = word.replace(/^\$/, "").toUpperCase();
+    return { code, command: ["gloomberb fn", code, args.length > 0 ? args.map(commandWord).join(" ") : found.argument].filter(Boolean).join(" ") };
+  } catch {
+    return null;
+  }
+}
+
 export async function runPaneFunction(args: string[], ctx: CliCommandContext) {
   await runPaneCliCommand(ctx, async () => {
     await withPaneRuntime(ctx, args, async ({ parsed, context, resolved }) => {

package/src/cli/pane-functions/lock-note.ts

@@ -0,0 +1,56 @@
+import { refusedLock } from "../../plugins/builtin/shared/cloud-denied";
+import { lockNoteReason } from "../../plugins/builtin/shared/pro-lock-note";
+import { cliTerminalWidth, wrapText } from "../../utils/cli-output";
+import { reportFooterLines } from "../report-tables";
+import type { PaneFunctionReport } from "./report";
+import type { ResolvedPaneFunction } from "./resolver";
+
+/** The widest a lock note wraps to, as the catalog's text. */
+const LOCK_NOTE_WIDTH = 100;
+
+/** The closing line of a headless report whose pane was walled whole, as a rendered view's says it. */
+const LOCKED_VIEW_NOTE = "The pane is locked, so no values were read.";
+
+/** A pane's `reportLockNote`, wrapped for the text report. */
+export function lockNoteLines(note: string): string[] {
+  return wrapText(note, Math.min(cliTerminalWidth() ?? LOCK_NOTE_WIDTH, LOCK_NOTE_WIDTH));
+}
+
+/**
+ * What a headless report prints when the server refused its read behind a
+ * wall, as the rendered view of the same pane prints that wall: the pane's
+ * `reportLockNote`, no source line and `locked` in JSON. The refusal may be
+ * the error itself or the cause of the one a headless read wrote for it
+ * (`explainRefusal`). Null when the error is no such refusal or the pane has
+ * no note, and the error stands.
+ */
+export function lockedHeadlessReport(
+  resolved: ResolvedPaneFunction,
+  error: unknown,
+  /** The symbols the report was asked for, read once the error is known to be a refusal. */
+  symbolsOf: () => string[],
+): PaneFunctionReport | null {
+  const refused = refusedLock(error);
+  if (!refused || !resolved.pane.reportLockNote) return null;
+  const gate = refused.gate;
+  const symbols = symbolsOf();
+  const note = resolved.pane.reportLockNote({ ...refused, symbol: symbols[0] ?? null, token: resolved.token });
+  const reason = lockNoteReason(note);
+  return {
+    data: {
+      kind: resolved.headless?.shape ?? "rendered-view",
+      target: resolved.token,
+      capabilityId: resolved.capability.id,
+      symbols,
+      options: resolved.options,
+      rowCount: 0,
+      empty: true,
+      complete: false,
+      unavailableSymbols: symbols,
+      reason,
+      locked: gate,
+    },
+    text: [resolved.label, "", ...lockNoteLines(note), "", LOCKED_VIEW_NOTE].join("\n"),
+    tables: { tables: [], footer: reportFooterLines({ incomplete: reason, notes: [LOCKED_VIEW_NOTE] }) },
+  };
+}

package/src/components/command-bar/list/view.tsx

@@ -13,6 +13,7 @@ import {
 } from "../../../ui";
 import { displayWidth, truncateTextSegments, truncateToDisplayWidth } from "../../../utils/format";
 import { Spinner } from "../../ui";
+import { ClippedText } from "../../ui/display";
 import { useCommandBarPalette } from "../panel/palette";
 import { getRowPresentation } from "../view-model";
 import {
@@ -306,7 +307,7 @@ export const CommandBarListBody = memo(function CommandBarListBody({
         if (row.kind === "message") {
           return (
             <Box key={row.id} height={1} paddingLeft={labelEdgePadding} paddingRight={contentPadding} {...(!nativePaneChrome ? { onMouseScroll: onListScroll } : {})}>
-              <Text fg={palette.text}>{truncateToDisplayWidth(t(row.label), labelEdgeWidth)}</Text>
+              <ClippedText fg={palette.text} text={t(row.label)} width={labelEdgeWidth} />
             </Box>
           );
         }

package/src/components/index.ts

@@ -125,7 +125,7 @@ export { MarkdownText } from "./markdown-text";
 // this file is the public `gloomberb/components` surface: a kit component
 // reaches plugins only once it is added here.
 export {
-  ActionRow, Badge, BulletList, Button, ButtonActionScope, Checkbox, ChoiceDialog, ConfirmDialog, confirmDialog, DataTable,
+  ActionRow, Badge, BulletList, Button, ButtonActionScope, Checkbox, ChoiceDialog, ColumnGrid, ColumnGridPair, ConfirmDialog, confirmDialog, DataTable,
   DetailScrollBody, DialogFrame, DisclosureMarker, Divider, EmptyState, ExternalLink, ExternalLinkText, FieldGrid, FieldLabel,
   fieldGridColumns, fieldGridRows, FigureList, getMessageComposerBlockHeight, GridFieldView, Icon, ICON_GLYPHS,
   IconButton, InlineQuickAddRow, KeyValueRow, ListView, loadingText, Menu, MenuPopover,
@@ -136,7 +136,8 @@ export {
   useFieldRing, usePaneLinkMenuEntry, useQueryBarSearch,
 } from "./ui";
 export type {
-  ActionRowProps, BadgeProps, BulletListProps, ButtonProps, ButtonVariant, CheckboxProps, ChoiceDialogChoice, ConfirmDialogOptions,
+  ActionRowProps, BadgeProps, BulletListProps, ButtonProps, ButtonVariant, CheckboxProps, ChoiceDialogChoice, ColumnGridCell,
+  ColumnGridColumn, ColumnGridPairProps, ColumnGridProps, ConfirmDialogOptions,
   DataTableCell, DataTableColumn, DataTableProps, DataTableVisibleRange, DetailScrollBodyProps, DialogFrameProps,
   DisclosureMarkerProps, DividerProps, EmptyStateProps, FieldGridProps, FieldLabelProps, FieldRing, FieldRingOptions,
   FigureListItem, FigureListProps, GridField,

package/src/components/layout/header.tsx

@@ -28,14 +28,29 @@ import { useAppDispatch, useAppSelector } from "../../state/app/context";
 import { useViewport } from "../../react/input";
 import { canRetryUpdate } from "../../app/global-shortcuts";
 import { t, tf } from "../../i18n";
-import { truncateToDisplayWidth } from "../../utils/format";
+import { displayWidth, truncateToDisplayWidth } from "../../utils/format";
+import { ClippedText } from "../ui/display";
 import { resolveMarketSummaryFit, useMarketSummary } from "./market-summary";
 import { resolveHeaderPromptGeometry } from "./shell/chrome";
 import { useWindowFullscreen } from "./window-fullscreen";
 import { WindowControls, WINDOWS_CONTROL_GROUP_WIDTH_PX } from "./window-controls";
-import { Button } from "../ui/button";
+import { Button, terminalButtonColumns } from "../ui/button";
 
 const UPDATE_NOTICE_DURATION_MS = 5_000;
+/**
+ * The failed-update message is cut to the room it has, but not below this many
+ * columns ("Update fa..."): narrower says nothing, so the banner is left out.
+ * The retry hint gives way before the message goes under it.
+ */
+const UPDATE_ERROR_MIN_COLUMNS = 12;
+/** Kept clear after the failed-update banner, so its last character never touches the Help pill. */
+const UPDATE_ERROR_GAP_COLUMNS = 1;
+/** Left padding of the update status's slot, in cells; the desktop's title-bar layout also pads its right. */
+const UPDATE_SLOT_PADDING_COLUMNS = 2;
+/** The Help pill's own props, shared by its button and the width the update status leaves it. */
+const helpButtonProps = () => ({ label: "Open Help", displayLabel: t("Help"), shortcut: "?", compact: true });
+/** The terminal pads the pill's right edge by a cell; the desktop pads it in px. */
+const TERMINAL_HELP_PADDING_COLUMNS = 1;
 
 type HeaderActionEvent = {
   key?: string;
@@ -157,11 +172,17 @@ function HeaderPromptInput({
         placeholderColor={subtleColor}
         cursorColor={colors.textBright}
       />
-      {ghostSuffix && (
+      {ghostSuffix && (nativePaneChrome ? (
+        // The desktop sets the suggestion right after the typed text, one
+        // character per `ch` of the field's font, and cuts it where the field ends.
+        <Box position="absolute" top={0} height={1} flexDirection="row" style={{ left: `${displayWidth(query)}ch`, right: 0 }}>
+          <ClippedText fg={subtleColor} text={ghostSuffix} width={0} />
+        </Box>
+      ) : (
         <Box position="absolute" top={0} left={ghostLeft} width={Math.max(0, width - ghostLeft)} height={1}>
           <Text fg={subtleColor}>{truncateToDisplayWidth(ghostSuffix, Math.max(0, width - ghostLeft))}</Text>
         </Box>
-      )}
+      ))}
     </Box>
   );
 }
@@ -244,8 +265,14 @@ function HeaderCommandPrompt({
   );
 }
 
-function UpdateStatus({ onRestart }: { onRestart?: () => void }) {
+/**
+ * What the header says about an update. In the terminal it is cut to `columns`,
+ * the room its slot is guaranteed (the desktop clips it in CSS where the slot
+ * ends), so it never runs into the Help pill or the market cluster beside it.
+ */
+function UpdateStatus({ columns, onRestart }: { columns: number; onRestart?: () => void }) {
   const colors = useThemeColors();
+  const { nativePaneChrome = false } = useUiCapabilities();
   const dispatch = useAppDispatch();
   const updateAvailable = useAppSelector((state) => state.updateAvailable);
   const updateProgress = useAppSelector((state) => state.updateProgress);
@@ -301,11 +328,20 @@ function UpdateStatus({ onRestart }: { onRestart?: () => void }) {
       return <Text fg={colors.headerText}>{t(updateProgress.message ?? "Update ready, restart to apply")}</Text>;
     }
     if (updateProgress.phase === "error") {
+      // One line: an error that carries a stack or a command's output must not grow the header.
+      const message = tf("Update failed: {error}", { error: (updateProgress.error ?? "Unknown error").replace(/\s+/g, " ").trim() });
       const retry = updateKey && canRetryUpdate({ updateAvailable, updateProgress, updateCheckInProgress });
+      const hint = retry ? `  ${updateKey} ${t("retry")}` : "";
+      const hintColumns = displayWidth(hint);
+      // The message goes first, and keeps its room before the hint takes any.
+      const room = columns - UPDATE_ERROR_GAP_COLUMNS;
+      const showHint = hintColumns > 0 && (nativePaneChrome || room - hintColumns >= UPDATE_ERROR_MIN_COLUMNS);
+      const messageColumns = room - (showHint ? hintColumns : 0);
+      if (!nativePaneChrome && messageColumns < UPDATE_ERROR_MIN_COLUMNS) return null;
       return (
-        <Box flexDirection="row">
-          <Text fg={colors.headerText}>{tf("Update failed: {error}", { error: updateProgress.error ?? "Unknown error" })}</Text>
-          {retry ? <Text fg={blendHex(colors.headerText, colors.header, 0.62)}>{`  ${updateKey} ${t("retry")}`}</Text> : null}
+        <Box flexDirection="row" overflow="hidden" paddingRight={UPDATE_ERROR_GAP_COLUMNS}>
+          <ClippedText fg={colors.headerText} text={message} width={messageColumns} />
+          {showHint ? <Text fg={blendHex(colors.headerText, colors.header, 0.62)}>{hint}</Text> : null}
         </Box>
       );
     }
@@ -404,11 +440,11 @@ function HeaderHelpButton({ nativePaneChrome, onPress }: { nativePaneChrome: boo
   return (
     <Box
       flexShrink={0}
-      paddingRight={nativePaneChrome ? undefined : 1}
+      paddingRight={nativePaneChrome ? undefined : TERMINAL_HELP_PADDING_COLUMNS}
       data-gloom-role="header-help-action"
       style={nativePaneChrome ? { marginRight: 8 } : undefined}
     >
-      <Button compact label="Open Help" displayLabel={t("Help")} shortcut="?" onPress={onPress} stopPropagation />
+      <Button {...helpButtonProps()} onPress={onPress} stopPropagation />
     </Box>
   );
 }
@@ -437,6 +473,14 @@ export function Header({
     windowFullscreen,
   });
   const shortcutLabel = useCommandBarShortcut();
+  // The terminal lays the header out by cell counts, so it works out what is left
+  // for the update status once the Help pill and the slot's padding are paid for.
+  const updateStatusColumns = Math.max(
+    0,
+    prompt.updateColumns
+      - (onOpenHelp ? terminalButtonColumns(helpButtonProps()) + TERMINAL_HELP_PADDING_COLUMNS : 0)
+      - UPDATE_SLOT_PADDING_COLUMNS * (titleBarOverlay ? 2 : 1),
+  );
   // Desktop has its own window chrome to sit on; the terminal has none, so the
   // bar itself wears the prompt's fill and reads as a single strip.
   const headerBg = nativePaneChrome ? colors.header : headerSurface(colors);
@@ -483,8 +527,8 @@ export function Header({
       >
         <Box width={prompt.left} />
         {commandPrompt}
-        <Box flexGrow={1} paddingLeft={2} paddingRight={2} minWidth={0}>
-          <UpdateStatus onRestart={onRestartForUpdate} />
+        <Box flexGrow={1} paddingLeft={UPDATE_SLOT_PADDING_COLUMNS} paddingRight={UPDATE_SLOT_PADDING_COLUMNS} minWidth={0}>
+          <UpdateStatus columns={updateStatusColumns} onRestart={onRestartForUpdate} />
         </Box>
         {onOpenHelp ? <HeaderHelpButton nativePaneChrome onPress={onOpenHelp} /> : null}
         {marketSummary}
@@ -505,8 +549,8 @@ export function Header({
     >
       <Box width={prompt.left} />
       {commandPrompt}
-      <Box flexGrow={1} minWidth={0} paddingLeft={2}>
-        <UpdateStatus onRestart={onRestartForUpdate} />
+      <Box flexGrow={1} minWidth={0} paddingLeft={UPDATE_SLOT_PADDING_COLUMNS}>
+        <UpdateStatus columns={updateStatusColumns} onRestart={onRestartForUpdate} />
       </Box>
       {onOpenHelp ? <HeaderHelpButton nativePaneChrome={nativePaneChrome} onPress={onOpenHelp} /> : null}
       {marketSummary}

package/src/components/layout/shell/chrome.ts

@@ -73,6 +73,12 @@ export interface HeaderPromptGeometry {
   width: number;
   /** Columns held at the header's right edge for the market cluster. */
   marketColumns: number;
+  /**
+   * Columns between the prompt and the market cluster: the update status, its
+   * padding and the Help pill share them. Never negative, so a window too narrow
+   * for the header reads as no room rather than a negative width.
+   */
+  updateColumns: number;
 }
 
 /**
@@ -95,14 +101,14 @@ export function resolveHeaderPromptGeometry(options: {
     ? getTitlebarLeadingInset({ platform, windowFullscreen })
     : 0;
   const left = leadingInset + 1;
-  const updateColumns = headerPromptUpdateColumns(termWidth);
-  const marketColumns = headerMarketColumns(termWidth, left, updateColumns);
+  const updateReserve = headerPromptUpdateColumns(termWidth);
+  const marketColumns = headerMarketColumns(termWidth, left, updateReserve);
   const width = Math.max(
     HEADER_PROMPT_MIN_WIDTH,
     Math.min(
       resolveCommandSurfaceWidth({ nativePaneChrome, termWidth }),
-      termWidth - left - updateColumns - marketColumns,
+      termWidth - left - updateReserve - marketColumns,
     ),
   );
-  return { left, width, marketColumns };
+  return { left, width, marketColumns, updateColumns: Math.max(0, termWidth - left - width - marketColumns) };
 }