gloomberb 0.10.3 → 0.10.4

package/src/components/command-bar/assist/runtime.ts

@@ -0,0 +1,185 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+import {
+  apiClient,
+  type AssistCommandCandidate,
+  type AssistCommandDescriptor,
+} from "../../../api-client";
+import { ApiRequestError } from "../../../api-client/errors";
+import type { AssistErrorKind, AssistRequestSource, AssistRequestState } from "./model";
+
+/** Quiet period after the last keystroke before the query is sent. */
+const ASSIST_DEBOUNCE_MS = 600;
+/** How long background asks stay off after the server rate-limits us. */
+const ASSIST_RATE_LIMIT_BACKOFF_MS = 60_000;
+
+/** Maps a failed `/assist/command` call onto the row the user should see. */
+function classifyAssistError(error: unknown): AssistErrorKind {
+  const status = error instanceof ApiRequestError ? error.status : undefined;
+  if (status === 503) return "unavailable";
+  if (status === 429) return "rate-limited";
+  return "failed";
+}
+
+/**
+ * Owns the `/assist/command` request for the root command-bar list. A query the
+ * prefix parser cannot claim is sent on its own once typing settles; answers are
+ * memoized for the life of the bar so backspacing never re-asks, and a rate
+ * limit silently parks background asks for a minute.
+ */
+export function useCommandBarAssist({
+  autoAsk,
+  getInventory,
+  rootQuery,
+}: {
+  /** Whether this query qualifies for a background ask right now. */
+  autoAsk: boolean;
+  getInventory: () => AssistCommandDescriptor[];
+  rootQuery: string;
+}): {
+  /** False once Esc has dismissed the section for the query still in the bar. */
+  assistActive: boolean;
+  assistState: AssistRequestState;
+  askAssist: () => void;
+  resetAssist: () => boolean;
+} {
+  const [assistState, setAssistState] = useState<AssistRequestState>({ status: "idle" });
+  const assistStateRef = useRef(assistState);
+  assistStateRef.current = assistState;
+  const abortRef = useRef<AbortController | null>(null);
+  const debounceRef = useRef<ReturnType<typeof setTimeout> | null>(null);
+  const answersRef = useRef(new Map<string, AssistCommandCandidate[]>());
+  /**
+   * The query the runtime has already acted on, updated the moment a request
+   * starts. Rendered state lags a tick behind, and reading it instead would let
+   * a re-render slip a second debounce past an ask that is already in flight.
+   */
+  const handledQueryRef = useRef<string | null>(null);
+  /** Query the user dismissed with Esc; the section stays gone until it changes. */
+  const dismissedQueryRef = useRef<string | null>(null);
+  /** Query the user asked for themselves, so its failures are worth a row. */
+  const explicitQueryRef = useRef<string | null>(null);
+  const rateLimitedUntilRef = useRef(0);
+  const rootQueryRef = useRef(rootQuery);
+  rootQueryRef.current = rootQuery;
+  const getInventoryRef = useRef(getInventory);
+  getInventoryRef.current = getInventory;
+
+  const cancelPending = useCallback(() => {
+    if (debounceRef.current) {
+      clearTimeout(debounceRef.current);
+      debounceRef.current = null;
+    }
+    abortRef.current?.abort();
+    abortRef.current = null;
+  }, []);
+
+  const resetAssist = useCallback((): boolean => {
+    const active = assistStateRef.current;
+    // Background rows are ambient: Esc belongs to whoever is listening next.
+    if (active.status === "idle" || active.source === "auto") return false;
+    cancelPending();
+    dismissedQueryRef.current = active.query;
+    setAssistState({ status: "idle" });
+    return true;
+  }, [cancelPending]);
+
+  const runAssist = useCallback((query: string, source: AssistRequestSource) => {
+    const trimmed = query.trim();
+    if (!trimmed) return;
+    cancelPending();
+    handledQueryRef.current = trimmed;
+    // A background ask the user has since claimed answers to them, not to the
+    // debounce, so its outcome is reported rather than swallowed.
+    const resolveSource = (): AssistRequestSource => (
+      explicitQueryRef.current === trimmed ? "explicit" : source
+    );
+
+    const cached = answersRef.current.get(trimmed);
+    if (cached) {
+      setAssistState({ status: "answered", query: trimmed, source: resolveSource(), candidates: cached });
+      return;
+    }
+
+    const controller = new AbortController();
+    abortRef.current = controller;
+    setAssistState({ status: "loading", query: trimmed, source: resolveSource() });
+
+    void (async () => {
+      try {
+        const response = await apiClient.assistCommand(trimmed, getInventoryRef.current(), {
+          signal: controller.signal,
+        });
+        if (controller.signal.aborted) return;
+        const candidates = response?.candidates ?? [];
+        answersRef.current.set(trimmed, candidates);
+        setAssistState({ status: "answered", query: trimmed, source: resolveSource(), candidates });
+      } catch (error) {
+        if (controller.signal.aborted) return;
+        const kind = classifyAssistError(error);
+        if (kind === "rate-limited") {
+          rateLimitedUntilRef.current = Date.now() + ASSIST_RATE_LIMIT_BACKOFF_MS;
+        }
+        setAssistState({ status: "error", query: trimmed, source: resolveSource(), kind });
+      } finally {
+        if (abortRef.current === controller) abortRef.current = null;
+      }
+    })();
+  }, [cancelPending]);
+
+  const askAssist = useCallback(() => {
+    const trimmed = rootQueryRef.current.trim();
+    if (!trimmed) return;
+    explicitQueryRef.current = trimmed;
+    const active = assistStateRef.current;
+    // The background ask already on the wire asks this exact question; asking
+    // again would only abort it and start the wait over.
+    if (active.status === "loading" && active.query === trimmed) {
+      setAssistState({ ...active, source: "explicit" });
+      return;
+    }
+    runAssist(trimmed, "explicit");
+  }, [runAssist]);
+
+  useEffect(() => {
+    const trimmed = rootQuery.trim();
+    const active = assistStateRef.current;
+    if (active.status !== "idle" && active.query !== trimmed) {
+      setAssistState({ status: "idle" });
+    }
+    if (handledQueryRef.current !== null && handledQueryRef.current !== trimmed) {
+      // Whatever is in flight describes text the user has already moved past.
+      cancelPending();
+      handledQueryRef.current = null;
+    }
+
+    if (!autoAsk || dismissedQueryRef.current === trimmed) return;
+    // An answer, a failure, or an in-flight ask for this exact text stands.
+    if (handledQueryRef.current === trimmed) return;
+    const cached = answersRef.current.get(trimmed);
+    if (cached) {
+      handledQueryRef.current = trimmed;
+      setAssistState({ status: "answered", query: trimmed, source: "auto", candidates: cached });
+      return;
+    }
+    if (Date.now() < rateLimitedUntilRef.current) return;
+
+    debounceRef.current = setTimeout(() => {
+      debounceRef.current = null;
+      runAssist(trimmed, "auto");
+    }, ASSIST_DEBOUNCE_MS);
+    return () => {
+      if (!debounceRef.current) return;
+      clearTimeout(debounceRef.current);
+      debounceRef.current = null;
+    };
+  }, [autoAsk, cancelPending, rootQuery, runAssist]);
+
+  useEffect(() => cancelPending, [cancelPending]);
+
+  return {
+    assistActive: dismissedQueryRef.current !== rootQuery.trim(),
+    assistState,
+    askAssist,
+    resetAssist,
+  };
+}

package/src/components/command-bar/commands/direct/index.ts

@@ -238,7 +238,7 @@ export function runDirectCommandAction(options: {
       const next = resolveLanguageCommandPreference(current, arg);
       if (!next) {
         notify(
-          `${t("Unsupported language")}: ${arg.trim()}. LANG auto | en | zh-CN | zh-TW | ja | ko`,
+          `${t("Unsupported language")}: ${arg.trim()}. LANG auto | en | es | zh-CN | zh-TW | ja | ko`,
           { type: "error" },
         );
         return;

package/src/components/command-bar/keyboard-shortcuts.ts

@@ -44,6 +44,8 @@ interface CommandBarKeyboardShortcutArgs {
     field: CommandBarWorkflowField,
   ) => void;
   popRoute: () => void;
+  /** Clears an AI assist request; returns true when Esc was spent on it. */
+  resetAssist: () => boolean;
   rootModeKind: string;
   setActiveListQuery: (query: string) => void;
   submitWorkflowRoute: (route: CommandBarWorkflowRoute) => void | Promise<void>;
@@ -70,6 +72,7 @@ export function useCommandBarKeyboardShortcuts({
   nativePaneChrome,
   openWorkflowFieldPicker,
   popRoute,
+  resetAssist,
   rootModeKind,
   setActiveListQuery,
   submitWorkflowRoute,
@@ -83,6 +86,8 @@ export function useCommandBarKeyboardShortcuts({
     if (event.name === "escape" || event.name === "`") {
       event.stopPropagation();
       event.preventDefault();
+      // Esc first backs out of an AI answer, leaving the query and bar intact.
+      if (event.name === "escape" && !currentRoute && resetAssist()) return;
       dismissCommandBar();
       return;
     }

package/src/components/command-bar/list/model.ts

@@ -9,6 +9,14 @@ export interface ResultItem {
   right?: string;
   shortcutQuery?: string;
   searchText?: string;
+  /** Tints the trailing marker and the section heading with the AI accent. */
+  accent?: boolean;
+  /**
+   * Set false for rows that answer nothing on their own — a placeholder, or an
+   * offer the user never asked for. The list skips them when it picks the
+   * selection for an untouched query, so plain Enter always runs a real match.
+   */
+  defaultSelectable?: boolean;
   pluginToggle?: () => void | Promise<void>;
   secondaryAction?: () => void | Promise<void>;
   checked?: boolean;
@@ -37,7 +45,7 @@ export interface ListScreenState {
 
 export type CommandBarListRow =
   | { kind: "spacer"; id: string }
-  | { kind: "heading"; id: string; label: string }
+  | { kind: "heading"; id: string; label: string; accent?: boolean }
   | { kind: "item"; item: ResultItem; globalIdx: number }
   | { kind: "message"; id: string; label: string; dim?: boolean }
   | { kind: "spinner"; id: string; label: string }
@@ -58,7 +66,12 @@ export function buildListRows(listState: ListScreenState): CommandBarListRow[] {
     if (sectionIndex > 0) {
       rows.push({ kind: "spacer", id: `spacer:${sectionIndex}:${section.category}` });
     }
-    rows.push({ kind: "heading", id: `heading:${sectionIndex}:${section.category}`, label: section.category });
+    rows.push({
+      kind: "heading",
+      id: `heading:${sectionIndex}:${section.category}`,
+      label: section.category,
+      accent: section.items.some((item) => item.accent),
+    });
     for (const item of section.items) {
       rows.push({ kind: "item", item, globalIdx });
       globalIdx += 1;

package/src/components/command-bar/list/navigation.ts

@@ -6,6 +6,7 @@ import type { CommandBarListScrollEvent } from "./view";
 interface CommandBarListNavigationOptions {
   activateListSelectionRef: RefObject<(options?: { secondary?: boolean; item?: ResultItem }) => void>;
   currentRouteRef: RefObject<CommandBarRoute | null>;
+  markRootSelectionNavigated: () => void;
   setRootHoveredIdx: Dispatch<SetStateAction<number | null>>;
   setRootSelectedIdx: Dispatch<SetStateAction<number>>;
   setRouteStack: Dispatch<SetStateAction<CommandBarRoute[]>>;
@@ -19,6 +20,7 @@ function clampListIndex(index: number, length: number): number {
 export function useCommandBarListNavigation({
   activateListSelectionRef,
   currentRouteRef,
+  markRootSelectionNavigated,
   setRootHoveredIdx,
   setRootSelectedIdx,
   setRouteStack,
@@ -35,6 +37,7 @@ export function useCommandBarListNavigation({
     visibleListStateRef.current = nextListState;
 
     if (!currentRouteRef.current) {
+      markRootSelectionNavigated();
       setRootSelectedIdx((current) => (current === nextIndex ? current : nextIndex));
       setRootHoveredIdx((current) => (current === null ? current : null));
       return;
@@ -52,6 +55,7 @@ export function useCommandBarListNavigation({
     });
   }, [
     currentRouteRef,
+    markRootSelectionNavigated,
     setRootHoveredIdx,
     setRootSelectedIdx,
     setRouteStack,
@@ -94,6 +98,7 @@ export function useCommandBarListNavigation({
     event.stopPropagation?.();
     event.preventDefault?.();
     if (!currentRouteRef.current) {
+      markRootSelectionNavigated();
       setRootSelectedIdx((current) => (current === globalIdx ? current : globalIdx));
     } else {
       setRouteStack((current) => {
@@ -112,6 +117,7 @@ export function useCommandBarListNavigation({
   }, [
     activateListSelectionRef,
     currentRouteRef,
+    markRootSelectionNavigated,
     setRootSelectedIdx,
     setRouteStack,
   ]);

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

@@ -81,7 +81,7 @@ export const CommandBarListHeader = memo(function CommandBarListHeader({
             ref={inputRef}
             value={query}
             onInput={onQueryChange}
-            placeholder={kind === "root" ? t("Search commands") : title === "Security Description" ? t("Search tickers") : t("Filter")}
+            placeholder={kind === "root" ? t("Command or plain English…") : title === "Security Description" ? t("Search tickers") : t("Filter")}
             focused
             data-gloom-remote-scope="command-bar"
             data-gloom-remote-surface="command-bar"
@@ -136,6 +136,7 @@ interface CommandBarListItemRowProps {
   labelWidth: number;
   trailingWidth: number;
   nativePaneChrome: boolean;
+  paletteAccentText: string;
   paletteBg: string;
   paletteHoverBg: string;
   paletteSelectedBg: string;
@@ -160,6 +161,7 @@ const CommandBarListItemRow = memo(function CommandBarListItemRow({
   labelWidth,
   trailingWidth,
   nativePaneChrome,
+  paletteAccentText,
   paletteBg,
   paletteHoverBg,
   paletteSelectedBg,
@@ -234,7 +236,15 @@ const CommandBarListItemRow = memo(function CommandBarListItemRow({
         </Text>
       </Box>
       <Box width={trailingWidth}>
-        <Text fg={isSelected ? paletteSelectedText : paletteSubtleText}>{trailing}</Text>
+        <Text
+          fg={isSelected
+            ? paletteSelectedText
+            : presentation.trailingAccent
+              ? paletteAccentText
+              : paletteSubtleText}
+        >
+          {trailing}
+        </Text>
       </Box>
     </Box>
   );
@@ -248,6 +258,7 @@ interface CommandBarListBodyProps {
   labelWidth: number;
   nativePaneChrome: boolean;
   nativeListScrollRef: RefObject<ScrollBoxRenderable | null>;
+  paletteAccentText: string;
   paletteBg: string;
   paletteHeadingText: string;
   paletteHoverBg: string;
@@ -271,6 +282,7 @@ export const CommandBarListBody = memo(function CommandBarListBody({
   labelWidth,
   nativePaneChrome,
   nativeListScrollRef,
+  paletteAccentText,
   paletteBg,
   paletteHeadingText,
   paletteHoverBg,
@@ -322,7 +334,7 @@ export const CommandBarListBody = memo(function CommandBarListBody({
         if (row.kind === "heading") {
           return (
             <Box key={row.id} height={1} paddingX={contentPadding} {...(!nativePaneChrome ? { onMouseScroll: onListScroll } : {})}>
-              <Text attributes={TextAttributes.BOLD} fg={paletteHeadingText}>
+              <Text attributes={TextAttributes.BOLD} fg={row.accent ? paletteAccentText : paletteHeadingText}>
                 {truncateText(t(row.label), queryDisplayWidth)}
               </Text>
             </Box>
@@ -346,6 +358,7 @@ export const CommandBarListBody = memo(function CommandBarListBody({
             labelWidth={labelWidth}
             trailingWidth={trailingWidth}
             nativePaneChrome={nativePaneChrome}
+            paletteAccentText={paletteAccentText}
             paletteBg={paletteBg}
             paletteHoverBg={paletteHoverBg}
             paletteSelectedBg={paletteSelectedBg}

package/src/components/command-bar/pane-templates/workflow.ts

@@ -275,6 +275,7 @@ export function useCommandBarPaneTemplateActions({
     adaptTickerSearchRouteResult,
     createPaneTemplateItem,
     getAvailablePaneShortcutTemplates,
+    getAvailablePaneTemplates,
     nonShortcutPaneTemplateItems,
     openPaneTemplateWorkflow,
     paneShortcutItems,

package/src/components/command-bar/panel/body.tsx

@@ -77,6 +77,7 @@ export function CommandBarPanelBody({
   const themeColors = useThemeColors();
   const {
     inputBg,
+    paletteAccentText,
     paletteBg,
     paletteHeadingText,
     paletteHoverBg,
@@ -179,6 +180,7 @@ export function CommandBarPanelBody({
             labelWidth={labelWidth}
             nativePaneChrome={nativePaneChrome}
             nativeListScrollRef={nativeListScrollRef}
+            paletteAccentText={paletteAccentText}
             paletteBg={paletteBg}
             paletteHeadingText={paletteHeadingText}
             paletteHoverBg={paletteHoverBg}

package/src/components/command-bar/panel/index.tsx

@@ -1,6 +1,7 @@
 import { useLayoutEffect } from "react";
 import { Box } from "../../../ui";
 import {
+  commandBarAccentText,
   commandBarBg,
   commandBarHeadingText,
   commandBarHoverBg,
@@ -70,6 +71,7 @@ export function CommandBarPanel({
   workflowScrollRef,
 }: CommandBarPanelProps) {
   const colors = useThemeColors();
+  const paletteAccentText = commandBarAccentText(colors);
   const paletteBg = commandBarBg(colors);
   const paletteHeadingText = commandBarHeadingText(colors);
   const paletteHoverBg = commandBarHoverBg(colors);
@@ -172,6 +174,7 @@ export function CommandBarPanel({
           onWorkflowSubmit={onWorkflowSubmit}
           palette={{
             inputBg,
+            paletteAccentText,
             paletteBg,
             paletteHeadingText,
             paletteHoverBg,

package/src/components/command-bar/panel/runtime.ts

@@ -50,6 +50,7 @@ interface CommandBarPanelRuntimeOptions {
     value: CommandBarFieldValue | undefined,
   ) => string;
   getWorkflowInputRef: CommandBarPanelProps["getWorkflowInputRef"];
+  markRootSelectionNavigated: () => void;
   moveWorkflowFocus: (delta: number) => void;
   nativeListScrollRef: RefObject<ScrollBoxRenderable | null>;
   nativePaneChrome: boolean;
@@ -58,6 +59,7 @@ interface CommandBarPanelRuntimeOptions {
   persistConfig: (nextConfig: AppState["config"]) => void;
   pluginRegistry: PluginRegistry;
   popRoute: () => void;
+  resetAssist: () => boolean;
   rootGhostSuffix: string | null;
   rootModeKind: string;
   rootQueryLength: number;
@@ -101,6 +103,7 @@ export function useCommandBarPanelRuntime({
   focusWorkflowField,
   getWorkflowFieldStringValue,
   getWorkflowInputRef,
+  markRootSelectionNavigated,
   moveWorkflowFocus,
   nativeListScrollRef,
   nativePaneChrome,
@@ -109,6 +112,7 @@ export function useCommandBarPanelRuntime({
   persistConfig,
   pluginRegistry,
   popRoute,
+  resetAssist,
   rootGhostSuffix,
   rootModeKind,
   rootQueryLength,
@@ -145,6 +149,7 @@ export function useCommandBarPanelRuntime({
   } = useCommandBarListNavigation({
     activateListSelectionRef,
     currentRouteRef,
+    markRootSelectionNavigated,
     setRootHoveredIdx,
     setRootSelectedIdx,
     setRouteStack,
@@ -185,6 +190,7 @@ export function useCommandBarPanelRuntime({
     nativePaneChrome,
     openWorkflowFieldPicker,
     popRoute,
+    resetAssist,
     rootModeKind,
     setActiveListQuery,
     submitWorkflowRoute,

package/src/components/command-bar/panel/types.ts

@@ -18,6 +18,7 @@ import type {
 
 export interface CommandBarPanelPalette {
   inputBg: string;
+  paletteAccentText: string;
   paletteBg: string;
   paletteHeadingText: string;
   paletteHoverBg: string;

package/src/components/command-bar/routes/root/results.ts

@@ -6,6 +6,11 @@ import type {
 } from "../../../../types/plugin";
 import type { TickerRecord } from "../../../../types/ticker";
 import { fuzzyFilter } from "../../../../utils/fuzzy-search";
+import {
+  buildAssistResultItems,
+  shouldShowAssistRow,
+  type AssistRowHandlers,
+} from "../../assist/model";
 import { matchPrefix, type Command } from "../../commands/registry";
 import { isCollectionCommand } from "../../helpers";
 import type { ResultItem } from "../../list/model";
@@ -38,6 +43,8 @@ export interface RootResultModelOptions {
   activeCollectionId: string | null;
   activeTickerData: TickerRecord | null | undefined;
   activeTickerSymbol: string | null;
+  /** Natural-language fallback rows; omit to build the list without an AI section. */
+  assist?: AssistRowHandlers | null;
   availableCommands: Command[];
   buildLayoutItems: (query: string, options?: { confirmDangerousActions?: boolean }) => ResultItem[];
   buildPaneSettingItems: (paneId: string | null, query: string) => ResultItem[];
@@ -66,11 +73,22 @@ export interface RootResultModelOptions {
   tickerActionItems: () => ResultItem[];
 }
 
+/** An in-flight or answered request keeps its rows even if the heuristic lapses. */
+function isAssistSectionVisible(assist: AssistRowHandlers, query: string, resultCount: number): boolean {
+  if (!query.trim()) return false;
+  if (assist.state.status !== "idle" && assist.state.query === query.trim()) return true;
+  // Signed out there is nothing to wait for, so the older heuristic still picks
+  // the queries worth offering a sign-up row for.
+  if (!assist.enabled) return shouldShowAssistRow({ query, resultCount });
+  return assist.auto;
+}
+
 export function buildRootResultModel(options: RootResultModelOptions): RootResultModel {
   const {
     activeCollectionId,
     activeTickerData,
     activeTickerSymbol,
+    assist,
     availableCommands,
     buildLayoutItems,
     buildPaneSettingItems,
@@ -205,8 +223,16 @@ export function buildRootResultModel(options: RootResultModelOptions): RootResul
       ...tickerActionItems(),
       ...pluginCommandItems(),
     ];
-    items.push(...fuzzyFilter(allItems, rootQuery, (item) => `${item.label} ${item.searchText || ""} ${item.detail} ${item.right || ""}`));
+    const matchedItems = fuzzyFilter(allItems, rootQuery, (item) => `${item.label} ${item.searchText || ""} ${item.detail} ${item.right || ""}`);
+    items.push(...matchedItems);
   }
 
-  return { items, initialIdx };
+  // Built from the local matches, then moved above them: the AI answers the
+  // question the user typed, so it leads the list. Rows landing here renumber
+  // everything below, which the root selection effect absorbs by identity.
+  const assistItems = assist && isAssistSectionVisible(assist, rootQuery, items.length)
+    ? buildAssistResultItems({ ...assist, query: rootQuery })
+    : [];
+
+  return { items: [...assistItems, ...items], initialIdx };
 }