@gloom-sh/terminal 0.18.5 → 0.19.1

package/src/plugins/builtin/clinical-trials/sponsor-tickers.ts

@@ -6,16 +6,20 @@ import {
   validateOrganizationTickers,
   type OrganizationTicker,
 } from "../../../api-client/organization-tickers";
+import { createTtlCache, type TtlCache } from "../../../data/ttl-cache";
+import { findSponsorListings, type ListingFinder } from "./sponsor-listing";
 
 /**
- * A lead sponsor's ticker, only ever as Gloom Cloud resolved it. `none` is an
- * answer (no listed company, or a name that fits several); `failed` means it
- * was not looked up at all and says nothing about the sponsor.
+ * A lead sponsor's ticker, as Gloom Cloud resolved it, or, for a company it
+ * has no reviewed name for, as the listing search finds it (`listingSearch`).
+ * `none` is an answer (no listed company, or a name that fits several);
+ * `failed` means it was not looked up at all and says nothing about the
+ * sponsor.
  */
 export type SponsorTicker =
   | { kind: "pending" }
   | { kind: "listed"; ticker: string; exchange: string | null; entityName: string | null }
-  | { kind: "none"; entityName: string | null; ambiguous: boolean }
+  | { kind: "none"; entityName: string | null; ambiguous: boolean; listingSearch?: "done" }
   | { kind: "failed"; reason: string };
 
 /** A ticker only when one company and its listing were found; an ambiguous name never gets one. */
@@ -46,17 +50,21 @@ const sponsorKey = (name: string) => name.trim().replace(/\s+/g, " ").toLowerCas
  * never stored as having no ticker because the lookup did not happen.
  */
 export class SponsorTickerStore {
-  private readonly answers = new Map<string, { value: SponsorTicker; expiresAt: number }>();
+  private readonly answers: TtlCache<SponsorTicker>;
   private readonly failures = new Map<string, string>();
   private readonly inFlight = new Set<string>();
+  private readonly searching = new Set<string>();
+  private readonly searchFailures = new Set<string>();
   private readonly listeners = new Set<() => void>();
 
-  constructor(private readonly lookup: Lookup, private readonly now: () => number = Date.now) {}
+  constructor(private readonly lookup: Lookup, now: () => number = Date.now) {
+    this.answers = createTtlCache<SponsorTicker>({ ttlMs: CACHE_TTL_MS, now });
+  }
 
   get(name: string): SponsorTicker {
     const key = sponsorKey(name);
-    const answer = this.answers.get(key);
-    if (answer && answer.expiresAt > this.now()) return answer.value;
+    const answer = this.answers.peek(key);
+    if (answer) return answer;
     const reason = this.failures.get(key);
     return reason ? { kind: "failed", reason } : { kind: "pending" };
   }
@@ -86,8 +94,7 @@ export class SponsorTickerStore {
       keys.forEach((key) => this.inFlight.add(key));
       try {
         const results = await this.lookup(batch, signal);
-        const expiresAt = this.now() + CACHE_TTL_MS;
-        results.forEach((result, index) => this.answers.set(keys[index]!, { value: sponsorTickerFrom(result), expiresAt }));
+        results.forEach((result, index) => this.answers.set(keys[index]!, sponsorTickerFrom(result)));
       } catch (error) {
         // An abandoned lookup (its pane closed) is neither an answer nor a failure.
         if (!signal?.aborted) {
@@ -102,24 +109,94 @@ export class SponsorTickerStore {
     }));
   }
 
+  /**
+   * `load`, then `searchListings` for the companies among the names, but the
+   * caller waits no longer than `ms`: the lookups go on and tickers fill in
+   * when they answer.
+   */
+  async loadWithin(
+    names: readonly string[],
+    ms: number,
+    signal?: AbortSignal,
+    listings?: { companies: readonly string[]; find?: ListingFinder },
+  ): Promise<void> {
+    let timer: ReturnType<typeof setTimeout> | undefined;
+    const patience = new Promise<void>((resolve) => { timer = setTimeout(resolve, ms); });
+    const lookups = this.load(names, signal).then(() => listings ? this.searchListings(listings.companies, listings.find, signal) : undefined);
+    try {
+      await Promise.race([lookups, patience]);
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+
+  /**
+   * Looks the companies Gloom Cloud had no name for up in Gloom Cloud's
+   * search, the one that finds `Bayer` when it is typed, and keeps a primary
+   * listing as the sponsor's ticker (`findSponsorListings` says which names
+   * qualify). Only names Cloud answered with no company, no listing and no
+   * ambiguity are asked: a company it knows, and a name that fits several,
+   * stay as it said. Each name is searched once, all in one request; a search
+   * that failed waits for `retryFailed`, and tells nothing about the sponsor.
+   */
+  async searchListings(names: readonly string[], find: ListingFinder = findSponsorListings, signal?: AbortSignal): Promise<void> {
+    const asked = new Map<string, string>();
+    for (const name of names) {
+      const trimmed = name.trim();
+      const key = sponsorKey(trimmed);
+      const answer = this.answers.peek(key);
+      if (!trimmed || asked.has(key) || this.searching.has(key) || this.searchFailures.has(key)) continue;
+      if (answer?.kind !== "none" || answer.ambiguous || answer.entityName || answer.listingSearch) continue;
+      asked.set(key, trimmed);
+    }
+    if (asked.size === 0) return;
+    const keys = [...asked.keys()];
+    keys.forEach((key) => this.searching.add(key));
+    try {
+      const found = await find([...asked.values()], signal);
+      if (signal?.aborted) return;
+      let changed = false;
+      for (const [key, name] of asked) {
+        const listing = found.get(name) ?? null;
+        this.answers.set(key, listing
+          ? { kind: "listed", ticker: listing.ticker, exchange: listing.exchange, entityName: listing.entityName }
+          : { kind: "none", entityName: null, ambiguous: false, listingSearch: "done" });
+        changed ||= listing !== null;
+      }
+      if (changed) this.listeners.forEach((listener) => listener());
+    } catch {
+      // A failed search says nothing about the sponsor; it is asked again on retry.
+      if (!signal?.aborted) keys.forEach((key) => this.searchFailures.add(key));
+    } finally {
+      keys.forEach((key) => this.searching.delete(key));
+    }
+  }
+
   /** Forgets failed lookups, so the next `load` asks again. */
   retryFailed(): void {
-    if (this.failures.size === 0) return;
+    if (this.failures.size === 0 && this.searchFailures.size === 0) return;
     this.failures.clear();
+    this.searchFailures.clear();
     this.listeners.forEach((listener) => listener());
   }
 }
 
-const sponsorTickerStore = new SponsorTickerStore(async (names, signal) => (
+export const sponsorTickerStore = new SponsorTickerStore(async (names, signal) => (
   validateOrganizationTickers(await apiClient.getCloudOrganizationTickers(names, signal), names)
 ));
 
+export interface SponsorTickersOptions {
+  /** The company sponsors among `names`: the ones Cloud's search may look up when its ticker lookup has no name for them. */
+  companies?: readonly string[];
+  store?: SponsorTickerStore;
+}
+
 /**
  * The tickers for the sponsors on screen. Rows draw at once and tickers fill
  * in when the lookup answers; `retry` asks again for the ones that failed.
  * `sessionKey` changing (a sign-in) retries them too.
  */
-export function useSponsorTickers(names: readonly string[], sessionKey: string, store: SponsorTickerStore = sponsorTickerStore) {
+export function useSponsorTickers(names: readonly string[], sessionKey: string, { companies, store = sponsorTickerStore }: SponsorTickersOptions = {}) {
   const [version, setVersion] = useState(0);
   const [epoch, setEpoch] = useState(0);
   const [signal, setSignal] = useState<AbortSignal | null>(null);
@@ -134,10 +211,13 @@ export function useSponsorTickers(names: readonly string[], sessionKey: string,
     store.retryFailed();
   }, [sessionKey, store]);
   const namesKey = names.join("\n");
+  const companiesKey = (companies ?? []).join("\n");
   useEffect(() => {
     if (!signal || signal.aborted || !namesKey) return;
-    void store.load(namesKey.split("\n"), signal);
-  }, [epoch, namesKey, sessionKey, signal, store, version]);
+    void store.load(namesKey.split("\n"), signal).then(() => {
+      if (companiesKey) return store.searchListings(companiesKey.split("\n"), findSponsorListings, signal);
+    });
+  }, [companiesKey, epoch, namesKey, sessionKey, signal, store, version]);
   const retry = useCallback(() => {
     store.retryFailed();
     setEpoch((current) => current + 1);

package/src/plugins/builtin/clinical-trials/trial-pages.ts

@@ -0,0 +1,50 @@
+import type { PageRequest, RowPage } from "../../../components";
+import type { ClinicalTrial, ClinicalTrialsPage, StudiesQuery } from "./client";
+
+/** What one stage of the list asks the registry for on top of the search: a sponsor class to keep or to leave out. */
+export type TrialStage = Pick<StudiesQuery, "sponsorClasses" | "excludedSponsorClasses">;
+
+/** The companies' studies first and everything else after them. */
+export const COMPANIES_FIRST: readonly TrialStage[] = [{ sponsorClasses: ["INDUSTRY"] }, { excludedSponsorClasses: ["INDUSTRY"] }];
+
+/** Where a page continues: which stage it is in, and the registry's token inside it. */
+interface StageCursor {
+  stage: number;
+  token?: string;
+}
+
+/**
+ * Pages the registry through `stages` one after the other: a stage's studies
+ * come newest first, and when it has no more the next stage starts, so the
+ * list reaches a university's study only once the companies' are in. The
+ * registry pages by an opaque token, which the next page's offset keys; the
+ * first page always starts at the first stage, so a reload starts over. A
+ * stage with nothing in it goes straight on to the next, so an empty page is
+ * never the end of the list while a stage is left. `onPage` runs on a page's
+ * studies before it is handed over.
+ */
+export function createTrialPageLoader({ list, query, stages, onPage }: {
+  list: (query: StudiesQuery, signal: AbortSignal) => Promise<ClinicalTrialsPage>;
+  query: StudiesQuery;
+  stages: readonly TrialStage[];
+  onPage?: (trials: ClinicalTrial[], signal: AbortSignal) => Promise<void>;
+}): (request: Pick<PageRequest, "offset" | "signal">) => Promise<RowPage<ClinicalTrial>> {
+  const cursors = new Map<number, StageCursor>();
+  return async ({ offset, signal }) => {
+    let cursor: StageCursor | undefined = offset === 0 ? { stage: 0 } : cursors.get(offset);
+    while (cursor) {
+      const page: ClinicalTrialsPage = await list({ ...query, ...stages[cursor.stage], pageToken: cursor.token }, signal);
+      const next: StageCursor | null = page.nextPageToken ? { stage: cursor.stage, token: page.nextPageToken }
+        : cursor.stage + 1 < stages.length ? { stage: cursor.stage + 1 } : null;
+      if (page.trials.length === 0 && next && !page.nextPageToken) {
+        cursor = next;
+        continue;
+      }
+      const nextOffset = offset + page.trials.length;
+      if (next) cursors.set(nextOffset, next);
+      await onPage?.(page.trials, signal);
+      return { rows: page.trials, hasMore: !!next, nextOffset };
+    }
+    return { rows: [], hasMore: false };
+  };
+}

package/src/plugins/builtin/cloud/askg/manifest.ts

@@ -142,6 +142,8 @@ function headlessCandidates(registry: PaneFunctionCatalog): ManifestCandidate[]
     const pane = registry.panes.get(template.paneId);
     if (!pane) continue;
     templatedPaneIds.add(pane.id);
+    // An unlisted function (`listed: false`) is no tool, and its pane none in its place.
+    if (template.listed === false) continue;
     const definition = definitionFor(template, pane);
     if (!definition) continue;
     const token = template.shortcut?.prefix ?? template.id;

package/src/plugins/builtin/company-attention/building.tsx

@@ -1,3 +1,4 @@
+import { logFailure } from "../../../utils/log-failure";
 import { useCallback, useMemo, useRef, type ReactNode } from "react";
 import { isAccessDenied } from "../../../api-client/errors";
 import type { HiringBuildingFilter, HiringBuildingShift } from "../../../api-client/hiring";
@@ -60,7 +61,10 @@ export function HiringBuildingView({ symbol, width, height, focused, accessKey,
     try {
       const payload = snapshotSetting ? validateBuilding(snapshotSetting) : null;
       return payload && ("filter" in payload ? !symbol : payload.symbol.toUpperCase() === symbol?.toUpperCase()) ? payload : null;
-    } catch { return null; }
+    } catch (error) {
+      logFailure("company-attention.building", "Validate hiring building snapshot failed")(error);
+      return null;
+    }
   }, [snapshotSetting, symbol]);
   const loader = useCallback((force: boolean) => snapshot ? Promise.resolve({ payload: snapshot, stale: false, refreshError: null }) : loadBuilding(symbol, accessKey, filter, force), [snapshot, symbol, accessKey, filter]);
   const resource = useAsyncResource(loader, { initialData: () => cachedBuilding(symbol, accessKey, filter), clearOnError: isAccessDenied, keepPreviousData: true });

package/src/plugins/builtin/company-attention/client.ts

@@ -3,6 +3,7 @@ import type { AppAttentionFilter, AppAttentionPayload, AppRankPayload } from "..
 import type { HiringBoard, HiringBuildingBoard, HiringBuildingFilter, HiringBuildingShift, HiringCompanyBuilding, HiringCompanyMoves, HiringCompanySignals, HiringMixRow, HiringMove, HiringMovePosting, HiringMovesBoard, HiringMovesFilter, HiringMoveWeek, HiringPayload, HiringSignalGroup, HiringSignalsBoard, HiringSignalsFilter, HiringSummary, HiringWeekSignal } from "../../../api-client/hiring";
 import type { CloudJobsPostingDetail } from "../../../api-client/types";
 import { createPluginCache } from "../../../data/plugin-cache";
+import { createTtlCache } from "../../../data/ttl-cache";
 import { cachedCloudResource, loadCloudResource, unavailableOnServer } from "../shared/cloud-resource";
 import type { AppFocus, AttentionKind } from "./model";
 
@@ -19,7 +20,10 @@ const finite = (value: unknown) => typeof value === "number" && Number.isFinite(
 const positive = (value: unknown) => finite(value) && (value as number) >= 0;
 const fraction = (value: unknown) => positive(value) && (value as number) <= 1;
 const date = (value: unknown) => typeof value === "string" && Number.isFinite(Date.parse(value));
-const url = (value: unknown) => { try { return typeof value === "string" && ["https:", "http:"].includes(new URL(value).protocol); } catch { return false; } };
+const url = (value: unknown) => { try { return typeof value === "string" && ["https:", "http:"].includes(new URL(value).protocol); } catch {
+  // Intentional ignore: malformed URLs fail this web link field validator.
+  return false;
+} };
 function numericTree(value: unknown): boolean {
   if (typeof value === "number") return Number.isFinite(value);
   if (Array.isArray(value)) return value.every(numericTree);
@@ -165,21 +169,16 @@ export async function fetchAppRank(focus: AppFocus, days: number, offset = 0, si
 export const loadAppRank = (focus: AppFocus, access: string, days: number, force = false) => loadCloudResource(appRankCache, `${access}:${focus.store}:${focus.appId}:${focus.country}:${focus.chart}:${days}`, () => fetchAppRank(focus, days), { force });
 
 const POSTING_TTL_MS = 5 * 60_000;
-const postingCache = new Map<string, { at: number; posting: Promise<CloudJobsPostingDetail> }>();
+const postings = createTtlCache<CloudJobsPostingDetail>({ ttlMs: POSTING_TTL_MS });
 /**
  * The page HIRE's evidence row was read from: its title, place, date, pay,
  * hours and description. Kept a few minutes, so stepping back and forth
  * through the evidence does not read it again.
  */
 export function fetchPostingDetail(ticker: string, externalId: string, client: Pick<typeof apiClient, "getCloudJobsPosting"> = apiClient): Promise<CloudJobsPostingDetail> {
-  const key = `${ticker.toUpperCase()}:${externalId}`;
-  const cached = postingCache.get(key);
-  if (cached && Date.now() - cached.at < POSTING_TTL_MS) return cached.posting;
-  const posting = client.getCloudJobsPosting(ticker, { externalId }).then((detail) => {
+  return postings.load(`${ticker.toUpperCase()}:${externalId}`, async () => {
+    const detail = await client.getCloudJobsPosting(ticker, { externalId });
     if (!detail || typeof detail.title !== "string" || detail.externalId !== externalId) throw new Error("The server returned an unreadable posting.");
     return detail;
   });
-  postingCache.set(key, { at: Date.now(), posting });
-  posting.catch(() => postingCache.delete(key));
-  return posting;
 }

package/src/plugins/builtin/company-attention/evidence.ts

@@ -45,7 +45,10 @@ export function attentionScreenshotEvidence(kind: AttentionKind): PaneScreenshot
     read(value) {
       if (!isRecord(value) || value.kind !== kind || value.version !== 1 || value.complete !== true || !isRecord(value.payload)
         || !["table", "chart", "mix", "peers", "evidence", ...(kind === "hiring" ? ["moves", "expansion", "anomalies", "building"] : [])].includes(String(value.tab)) || !Array.isArray(value.rowIds) || !value.rowIds.every((id) => typeof id === "string") || value.plottedValueCount !== value.rowIds.length) return null;
-      try { if (!(kind === "apps" && Array.isArray(value.payload.rankHistory))) validateAttention(kind, value.payload as unknown as AttentionPayload); return value as unknown as AttentionEvidence; } catch { return null; }
+      try { if (!(kind === "apps" && Array.isArray(value.payload.rankHistory))) validateAttention(kind, value.payload as unknown as AttentionPayload); return value as unknown as AttentionEvidence; } catch {
+        // Intentional ignore: invalid captured observations are rejected as evidence by returning null.
+        return null;
+      }
     },
     mismatches(evidence, { resolved, payload }) {
       const settings = payload.config.layout.instances.find((entry) => entry.instanceId === payload.paneId)?.settings;

package/src/plugins/builtin/company-attention/headless.ts

@@ -3,6 +3,7 @@ import type { DataTableColumn } from "../../../components";
 import type { AppAttentionPayload, AppChart } from "../../../api-client/app-attention";
 import type { HiringBoard, HiringPayload } from "../../../api-client/hiring";
 import { fetchAppRank, fetchAttention, fetchBuilding, fetchMoves, fetchSignals, type BuildingPayload, type SignalsPayload } from "./client";
+import { companyDataNotes } from "../../../types/company-from";
 import { BUILDING_FILTERS, BUILDING_VIEWS, buildingBoardModel, buildingNumber, buildingPreviewNote, companyBuildingModel, isBuildingFilter, type BuildingSection } from "./building-model";
 import { appsModel, appsPreviewNote, attentionNumber, attentionSectionTitle, attentionTabs, hiringModel, hiringPreviewNote, remoteText, type AttentionKind } from "./model";
 import { companyMovesModel, isMovesFilter, movesBoardModel, movesNumber, movesPreviewNote, MOVES_FILTERS, MOVES_VIEWS, type MovesSection } from "./moves-model";
@@ -146,7 +147,7 @@ export function attentionHeadless(kind: AttentionKind): HeadlessPaneDefinition<"
       const why = movesModel?.latest?.why;
       const company = args.symbols[0] ? signalsReads[0]?.data : undefined;
       const held = company && !("group" in company) && company.held ? holdText(company.held) : null;
-      const notes = [...model.notices, ...(nextOffset !== null ? [`Additional observations available with --offset ${nextOffset}.`] : []),
+      const notes = [...model.notices, ...companyDataNotes("companyFrom" in data ? data.companyFrom : null), ...(nextOffset !== null ? [`Additional observations available with --offset ${nextOffset}.`] : []),
         ...(movesData instanceof Error ? [movesData.message] : []), ...(why ? [why] : []),
         ...(signalsData instanceof Error ? [signalsData.message] : []), ...(held ? [`No expansion or anomaly signal this week: ${held.toLowerCase()}.`] : []),
         ...(buildingData instanceof Error ? [buildingData.message] : []), ...(buildingHeld ? [`No mix to compare this week: ${buildingHeld.toLowerCase()}.`] : [])];

package/src/plugins/builtin/company-attention/moves.tsx

@@ -1,3 +1,4 @@
+import { logFailure } from "../../../utils/log-failure";
 import { useCallback, useMemo, useRef, type ReactNode } from "react";
 import { isAccessDenied } from "../../../api-client/errors";
 import type { HiringMovesFilter } from "../../../api-client/hiring";
@@ -63,7 +64,10 @@ export function HiringMovesView({ symbol, width, height, focused, accessKey, com
     try {
       const payload = snapshotSetting ? validateMoves(snapshotSetting) : null;
       return payload && ("moves" in payload ? !symbol : payload.symbol.toUpperCase() === symbol?.toUpperCase()) ? payload : null;
-    } catch { return null; }
+    } catch (error) {
+      logFailure("company-attention.moves", "Validate hiring moves snapshot failed")(error);
+      return null;
+    }
   }, [snapshotSetting, symbol]);
   const loader = useCallback((force: boolean) => snapshot ? Promise.resolve({ payload: snapshot, stale: false, refreshError: null }) : loadMoves(symbol, accessKey, filter, force), [snapshot, symbol, accessKey, filter]);
   const resource = useAsyncResource(loader, { initialData: () => cachedMoves(symbol, accessKey, filter), clearOnError: isAccessDenied, keepPreviousData: true });

package/src/plugins/builtin/company-attention/pane.tsx

@@ -1,9 +1,11 @@
+import { logFailure } from "../../../utils/log-failure";
 import { useCallback, useMemo, useRef } from "react";
 import { isAccessDenied } from "../../../api-client/errors";
 import { usePlanAccess } from "../../../api-client/plan-access";
 import type { AppAttentionFilter, AppAttentionPayload, AppChart } from "../../../api-client/app-attention";
 import type { HiringBoard, HiringPayload } from "../../../api-client/hiring";
 import { ChartTableHeader, DataTableView, PageStackView, PaneFooterScope, PaneLinkMenu, QueryBar, useChartTableSelection, usePagedRows, useTableLoadMore, usePaneNoticeFooter, usePaneStatusFooter, usePaneTabs, type PaneHint } from "../../../components";
+import { useCompanyDataFooter } from "../../../components/layout/pane/status-footer";
 import { DetailReader, type DetailFact } from "../../../components/reader/detail-reader";
 import type { CloudJobsPostingDetail } from "../../../api-client/types";
 import { descriptionText, postingFacts, postingTitle } from "../shared/job-posting";
@@ -57,7 +59,10 @@ function Evidence({ row, width, posting, source }: Size & { row: AttentionRow; p
 }
 /** A link's site, as a reader names it: "sec.gov". */
 function linkName(url: string): string {
-  try { return new URL(url).hostname.replace(/^www\./, ""); } catch { return "Source"; }
+  try { return new URL(url).hostname.replace(/^www\./, ""); } catch {
+    // Intentional ignore: a malformed link has no site to name, so it reads as Source.
+    return "Source";
+  }
 }
 
 export function HiringPane(props: Size) {
@@ -105,7 +110,10 @@ function AttentionView({ kind, symbol, width, height, focused, initialTab }: Siz
   const [mix, setMix] = usePluginPaneState<string>(`${kind}:mix`, kind === "hiring" ? "functions" : "countries");
   const filters = useMemo<AppAttentionFilter>(() => kind === "apps" ? { ...(country ? { country } : {}), ...(chart ? { chart: chart as AppChart } : {}), days: Number(days) || 90 } : {}, [kind, country, chart, days]);
   const [snapshotSetting] = usePaneSettingValue<AttentionPayload | null>("attentionSnapshot", null);
-  const snapshot = useMemo(() => { try { return snapshotSetting ? validateAttention(kind, snapshotSetting) : null; } catch { return null; } }, [kind, snapshotSetting]);
+  const snapshot = useMemo(() => { try { return snapshotSetting ? validateAttention(kind, snapshotSetting) : null; } catch (error) {
+    logFailure("company-attention.pane", "Validate attention snapshot failed")(error);
+    return null;
+  } }, [kind, snapshotSetting]);
   const loader = useCallback((force: boolean) => snapshot ? Promise.resolve({ payload: snapshot, stale: false, refreshError: null }) : loadAttention(kind, symbol, accessKey, filters, force), [kind, symbol, accessKey, filters, snapshot]);
   const resource = useAsyncResource(loader, { initialData: () => cachedAttention(kind, symbol, accessKey, filters), clearOnError: isAccessDenied });
   const data = resource.data?.payload;
@@ -177,6 +185,8 @@ function AttentionView({ kind, symbol, width, height, focused, initialTab }: Siz
   usePaneStatusFooter({ registrationId: `${kind}:status`, enabled: !openCompany && !app && !moves, loading: resource.loading || paged.loadingMore || (!!evidence && postingResource.loading), error: data ? resource.error ?? paged.moreError?.message ?? paged.error?.message : null, stale: resource.data?.stale,
     info: [...(model?.asOf ? [{ id: "observed", asOf: true, parts: [{ text: `as of ${model.asOf.slice(0, 10)}`, tone: "muted" as const }] }] : []), ...(model?.preview ? [{ id: "preview", parts: [{ text: "Pro preview", tone: "warning" as const }] }] : [])], hints });
   usePaneNoticeFooter({ registrationId: `${kind}:notices`, enabled: !openCompany && !app && !moves, focused, notices: [...(model?.notices ?? []), ...(resource.data?.refreshError ? [resource.data.refreshError] : [])] });
+  // A receipt's or foreign line's hiring or apps are its company's, read from the home line.
+  useCompanyDataFooter(data && "companyFrom" in data ? data.companyFrom : null, !openCompany && !app && !moves);
   if (signInWall) return <SignInWall placement={kind === "hiring" ? "hiring-momentum-signin" : "app-attention-signin"} action={kind === "hiring" ? "view hiring momentum" : "view app attention"} needsVerification={session.needsVerification} />;
   const countryOptions = data && kind === "apps" ? (data as AppAttentionPayload).coverage.configuredCountries : [];
   const query = kind === "hiring" && tab !== "mix" ? undefined : <QueryBar width={width} filters={kind === "apps" ? [

package/src/plugins/builtin/company-attention/signals.tsx

@@ -1,3 +1,4 @@
+import { logFailure } from "../../../utils/log-failure";
 import { useCallback, useMemo, useRef, type ReactNode } from "react";
 import { isAccessDenied } from "../../../api-client/errors";
 import type { HiringSignalGroup, HiringSignalsFilter, HiringWeekSignal } from "../../../api-client/hiring";
@@ -60,7 +61,10 @@ export function HiringSignalsView({ group, symbol, width, height, focused, acces
     try {
       const payload = snapshotSetting ? validateSignals(snapshotSetting) : null;
       return payload && ("group" in payload ? !symbol && payload.group === group : payload.symbol.toUpperCase() === symbol?.toUpperCase()) ? payload : null;
-    } catch { return null; }
+    } catch (error) {
+      logFailure("company-attention.signals", "Validate hiring signals snapshot failed")(error);
+      return null;
+    }
   }, [snapshotSetting, symbol, group]);
   const loader = useCallback((force: boolean) => snapshot ? Promise.resolve({ payload: snapshot, stale: false, refreshError: null }) : loadSignals(group, symbol, accessKey, filter, force), [snapshot, group, symbol, accessKey, filter]);
   const resource = useAsyncResource(loader, { initialData: () => cachedSignals(group, symbol, accessKey, filter), clearOnError: isAccessDenied, keepPreviousData: true });

package/src/plugins/builtin/company-kpis/headless.ts

@@ -1,11 +1,12 @@
 import type { DataTableColumn } from "../../../components";
 import { DATE_OPTION_EXAMPLES, isoDateOption } from "../../../utils/calendar-date";
 import { optionFlag } from "../../../cli/pane-functions/capabilities";
+import { companyDataNotes } from "../../../types/company-from";
 import type { HeadlessBundleSection, HeadlessPaneColumn, HeadlessPaneDefinition } from "../../../types/plugin";
 import { withoutQuietColumns } from "../shared/research-cells";
 import { resolveHeadlessIssuerListing } from "../shared/headless-market-data";
 import { companyQuery, fetchCompanyData, type CompanyDataset, type CompanyMode } from "./client";
-import { allGuidance, allObservations, companyCellText, companyColumns, companyPreviewNote, KPI_COVERAGE_NOTE, kpiFreeLimitNote, QUIET_COLUMNS,
+import { allGuidance, allObservations, companyCellText, companyColumns, companyEmptyState, companyPreviewNote, KPI_COVERAGE_NOTE, kpiFreeLimitNote, QUIET_COLUMNS,
   type CompanyRow } from "./model";
 import type { KpiObservation } from "../../../api-client/company-kpis";
 
@@ -107,8 +108,12 @@ export function companyHeadless(mode: CompanyMode): HeadlessPaneDefinition<"bund
       const latest = ("series" in data ? data.series.map((series) => series.latest) : data.guidance).filter(keep);
       const ignored = data.access === "preview" ? PRO_FILTERS.filter((key) => typeof args.options[key] === "string" && args.options[key] !== "") : [];
       const notes = [ageNote(data, latest, mode),
-        ignored.length ? `The free preview is fixed: ${ignored.map(optionFlag).join(", ")} ${ignored.length > 1 ? "need" : "needs"} Gloom Pro.` : null].filter((note): note is string => !!note);
-      return { complete: !data.truncated, errors: data.truncated ? [data.access === "preview" ? companyPreviewNote(data, mode === "guidance") : "Response limit reached; narrow the metric or date range"] : [],
+        ignored.length ? `The free preview is fixed: ${ignored.map(optionFlag).join(", ")} ${ignored.length > 1 ? "need" : "needs"} Gloom Pro.` : null,
+        ...companyDataNotes(data.companyFrom)].filter((note): note is string => !!note);
+      // A company with nothing on file says so once, as the pane does, rather than "not covered".
+      const nothingOnFile = datasetRows(data).length === 0 && data.lockedRows === 0 && !requested;
+      const { title, hint } = companyEmptyState(mode, symbol, { tab: "table", hasRows: !nothingOnFile }, "cli");
+      return { complete: !data.truncated, ...(nothingOnFile ? { empty: `${title} ${hint}` } : {}), errors: data.truncated ? [data.access === "preview" ? companyPreviewNote(data, mode === "guidance") : "Response limit reached; narrow the metric or date range"] : [],
         ...(notes.length ? { notes } : {}),
         sections: "series" in data ? [
           section("Latest KPIs", data.series.map((series) => series.latest), { first: true }),

package/src/plugins/builtin/company-kpis/model.ts

@@ -1,9 +1,11 @@
 import type { GuidancePayload, KpiGuidance, KpiObservation, KpiSeries, KpiUnit, KpisPayload } from "../../../api-client/company-kpis";
 import type { DataTableColumn } from "../../../components";
 import { scalarPoint, staticSeries } from "../../../components/chart/static/series";
+import { getTableWidth, tableColumnWidth } from "../../../components/ui/table-layout";
 import type { CompositeChartXAxis } from "../../../components/chart/composite/types";
 import { formatCompact, formatNumber } from "../../../utils/format";
 import { freePreviewNote } from "../shared/free-preview";
+import type { CompanyMode } from "./client";
 
 export type CompanyRow = KpiObservation | KpiGuidance;
 export const isGuidance = (row: CompanyRow): row is KpiGuidance => "issuedDate" in row;
@@ -89,13 +91,30 @@ function unitSuffix(row: Pick<CompanyRow, "unit" | "currency" | "dimensions">):
   if (row.unit === "currency_per_unit" || row.unit === "volume") return ` ${unitLabel(row)}`;
   return "";
 }
-/** Raised reads as good news, a cut as bad, a reiteration as no news. */
-export const directionTone = (direction: KpiGuidance["direction"]) => direction === "raised" ? "positive" as const : direction === "cut" ? "negative" as const
-  : direction === "withdrawn" ? "warning" as const : direction === "initiated" ? "text" as const : "muted" as const;
+/** Raised reads as good news, a cut as bad, a reiteration as no news, and a New guide as itself whichever way the service reached it. */
+export const directionTone = (guide: Pick<KpiGuidance, "direction" | "previousId">) => guide.direction === "raised" ? "positive" as const : guide.direction === "cut" ? "negative" as const
+  : guide.direction === "withdrawn" ? "warning" as const : directionLabel(guide) === "New" ? "text" as const : "muted" as const;
 /** A change is good when it moves the way the metric's owner wants it to. */
 export const changeTone = (row: KpiObservation, value: number | null) => value === null || value === 0 || row.metric.favorable === "neutral" ? "muted" as const
   : (value > 0) === (row.metric.favorable === "higher") ? "positive" as const : "negative" as const;
-export const directionLabel = (direction: KpiGuidance["direction"]) => direction === "not_comparable" ? "Not comparable" : direction.charAt(0).toUpperCase() + direction.slice(1);
+/**
+ * What a guide did against the one before it for the same period, in plain
+ * words. A guide with no earlier one to set it against is New, whether it is
+ * the company's first or the first for its period. The service sets a guide it
+ * cannot rank (a different hedge or conditions) beside its predecessor as not
+ * comparable: that one Changed, with no word for up or down.
+ */
+export function directionLabel(guide: Pick<KpiGuidance, "direction" | "previousId">): string {
+  switch (guide.direction) {
+    case "raised": return "Raised";
+    case "cut": return "Lowered";
+    case "reiterated": return "Maintained";
+    case "mixed": return "Mixed";
+    case "withdrawn": return "Withdrawn";
+    case "initiated": return "New";
+    case "not_comparable": return guide.previousId ? "Changed" : "New";
+  }
+}
 export const outcomeLabel = (row: KpiGuidance) => !row.actual ? "Pending" : row.actual.favorable === "in_line" ? "In range"
   : row.actual.favorable === "neutral" ? row.actual.outcome === "above" ? "Above" : row.actual.outcome === "below" ? "Below" : "In range"
   : row.actual.favorable === "beat" ? "Beat" : "Miss";
@@ -163,7 +182,7 @@ export const QUIET_COLUMNS = { basis: ["Reported"], scope: ["Consolidated"] };
 /** The text of a table cell as the pane draws it; the report prints the same words. */
 export function companyCellText(row: CompanyRow, column: string, observations: KpiObservation[]): string {
   const guide = isGuidance(row) ? row : null;
-  if (column === "change") return guide ? directionLabel(guide.direction) : changeText(observationChange(row as KpiObservation, observations));
+  if (column === "change") return guide ? directionLabel(guide) : changeText(observationChange(row as KpiObservation, observations));
   return column === "metric" ? row.metric.name : column === "period" ? fiscalLabel(row) : column === "value" ? `${guide ? rangeText(guide) : observationValue(row as KpiObservation)}${guide?.status === "withdrawn" || guide?.hedge === "qualitative" ? "" : unitSuffix(row)}`
     : column === "unit" ? unitLabel(row)
     : column === "basis" ? basisLabel(row.basis) : column === "scope" ? dimensionLabel(row.dimensions) || "Consolidated"
@@ -195,6 +214,55 @@ export function companyColumns(guidance: boolean, evidence: boolean, history: bo
   return order ? shown.sort((a, b) => order.indexOf(a.id) - order.indexOf(b.id)) : shown;
 }
 
+/** Cells a column gives up on a narrow pane, before any column is dropped: a date needs 10, a range about 19. */
+const NARROW_WIDTHS: Record<string, number> = { value: 19, change: 11, issued: 10, actual: 12, outcome: 9, basis: 12, scope: 18 };
+/** The metric keeps at least this much: a name such as "Revenue growth", and its series detail only when there is room. */
+const METRIC_FLOOR = 14;
+
+/**
+ * The table's columns at a pane `width` in cells, so none is cut at the right edge.
+ * A table that already fits is left as it is. Otherwise the columns take their
+ * narrow widths, and the metric, which flexes, keeps what is left down to its
+ * floor. Below that a column whose meaning is in the detail goes (Action in History,
+ * where the outcome says it, then Issued), never one that names the row. A table that
+ * cannot fit even so keeps its narrow widths and scrolls sideways, as it always has.
+ */
+export function fitCompanyColumns(columns: readonly DataTableColumn[], width: number, history = false): DataTableColumn[] {
+  const room = width - 1;
+  if (getTableWidth(columns) <= room) return [...columns];
+  const narrow = (list: readonly DataTableColumn[]) => list.map((column) => column.id in NARROW_WIDTHS ? { ...column, width: Math.min(column.width, NARROW_WIDTHS[column.id]!) } : column);
+  const attempt = (list: readonly DataTableColumn[]): DataTableColumn[] | null => {
+    const tight = narrow(list);
+    const metric = tight.find((column) => column.id === "metric");
+    if (!metric) return getTableWidth(tight) <= room ? tight : null;
+    const fitted = Math.min(metric.width, room - (getTableWidth(tight) - tableColumnWidth(metric)));
+    return fitted >= METRIC_FLOOR ? tight.map((column) => column === metric ? { ...column, width: fitted } : column) : null;
+  };
+  let shown = [...columns];
+  for (const drop of [null, ...(history ? ["change", "issued"] : ["issued"])]) {
+    if (drop) shown = shown.filter((column) => column.id !== drop);
+    const fitted = attempt(shown);
+    if (fitted) return fitted;
+  }
+  return narrow(columns);
+}
+
+/** Companies to point an empty pane at, one that has data and one for when the pane is for the first. */
+const EXAMPLE_COMPANIES: Record<CompanyMode, readonly string[]> = { guidance: ["WMT", "DAL"], kpis: ["AAPL", "NVDA"] };
+
+/**
+ * What an empty table says. A company with nothing on file for the function says so
+ * plainly and names one that has some; a selection or tab that narrows what the company
+ * has says what is missing from it. `cli` types `fn GUIDE WMT`, the app's command bar `GUIDE WMT`.
+ */
+export function companyEmptyState(mode: CompanyMode, symbol: string, view: { tab: string; hasRows: boolean }, surface: "cli" | "pane" = "pane"): { title: string; hint?: string } {
+  if (view.hasRows) return { title: view.tab === "history" ? "Actuals have not been matched to these guidance periods yet." : "No disclosed observations for this selection yet." };
+  const examples = EXAMPLE_COMPANIES[mode];
+  const example = examples.find((candidate) => candidate !== symbol.trim().toUpperCase()) ?? examples[0]!;
+  const command = `${mode === "kpis" ? "KPIS" : "GUIDE"} ${example}`;
+  return { title: `No ${mode === "kpis" ? "KPIs" : "guidance"} on file for ${symbol}.`, hint: `Try ${surface === "cli" ? `\`fn ${command}\`` : command}.` };
+}
+
 /** What a missing KPI means, as KPIS states it among its limitations and EQS beside a KPI column with gaps. */
 export const KPI_COVERAGE_NOTE = "Coverage follows available company disclosures; missing data is not zero.";