gloomberb 0.19.1 → 0.19.2

package/src/plugins/builtin/credit-conditions/client.ts

@@ -66,20 +66,28 @@ async function loadSeries(
   loader: CreditSeriesLoader,
 ) {
   const request = requestFor(definition.seriesId);
-  const result = await loadCachedFredSeries(
-    request,
-    async () => {
-      const data = trimHistory(await loader(definition.seriesId, {
-        limit: HISTORY_LIMIT,
-        sortOrder: "desc",
-      }));
-      // Reject incompatible source responses before they replace usable cache.
-      // The shared cache can then retain the dated prior value as stale fallback.
-      normalizeCreditSeries(definition, data);
-      return data;
-    },
-    { force },
-  );
+  let result: Awaited<ReturnType<typeof loadCachedFredSeries>>;
+  try {
+    result = await loadCachedFredSeries(
+      request,
+      async () => {
+        const data = trimHistory(await loader(definition.seriesId, {
+          limit: HISTORY_LIMIT,
+          sortOrder: "desc",
+        }));
+        // Reject incompatible source responses before they replace usable cache.
+        normalizeCreditSeries(definition, data);
+        return data;
+      },
+      { force },
+    );
+  } catch (error) {
+    // A refusal or a reply that fails validation is no saved copy's to answer: it is this row's
+    // error, beside the dated prior value already read, which stays as stale rather than vanish.
+    const kept = getCachedFredSeries(request, { allowExpired: true });
+    if (!kept) throw error;
+    return { row: normalizeCreditSeries(definition, kept.data, true), refreshError: error instanceof Error ? error.message : String(error) };
+  }
   return {
     row: normalizeCreditSeries(definition, result.data, result.stale),
     refreshError: result.refreshError,

package/src/plugins/builtin/crypto-board/client.ts

@@ -145,10 +145,10 @@ export async function fetchCryptoMarkets(
   try {
     return validateCryptoMarkets(await client.getCloudCryptoMarkets());
   } catch (error) {
-    if (error instanceof ApiRequestError && error.status === 503) {
-      throw new Error("Crypto prices are temporarily unavailable");
-    }
-    throw unavailableOnServer(error, "Crypto markets are not available yet.");
+    // Each keeps its status: a 503 passes with time and a saved copy answers it; a 404 does not.
+    throw error instanceof ApiRequestError && error.status === 503
+      ? unavailableOnServer(error, "Crypto prices are temporarily unavailable", [503])
+      : unavailableOnServer(error, "Crypto markets are not available yet.");
   }
 }
 
@@ -248,7 +248,7 @@ function validateStablecoinSupplyHistory(data: StablecoinSupplyHistoryPayload):
 }
 
 function supplyError(error: unknown, what: string): unknown {
-  if (error instanceof ApiRequestError && error.status === 503) return new Error(`${what} is temporarily unavailable`);
+  if (error instanceof ApiRequestError && error.status === 503) return unavailableOnServer(error, `${what} is temporarily unavailable`, [503]);
   return unavailableOnServer(error, `${what} is not available yet.`);
 }
 

package/src/plugins/builtin/crypto-board/series.ts

@@ -1,5 +1,5 @@
 import type { SeriesDefinition, SeriesPoint } from "../../../series/types";
-import { cachedSeriesWarning } from "../shared/series-warning";
+import { cachedSeriesNote } from "../shared/series-warning";
 import { loadDefiTvl, loadStablecoinSupply, loadStablecoinSupplyHistory } from "./client";
 
 const DAY_MS = 86_400_000;
@@ -29,7 +29,7 @@ const STABLECOIN_SUPPLY_SERIES: readonly SeriesDefinition[] = [
       const resource = await loadStablecoinSupply();
       const history = resource.payload.history;
       if (!history) throw new Error("Stablecoin supply is not available yet.");
-      return { points: dailyPoints(history.start, history.total), warning: cachedSeriesWarning(resource) };
+      return { points: dailyPoints(history.start, history.total), ...cachedSeriesNote(resource) };
     },
   },
   {
@@ -45,7 +45,7 @@ const STABLECOIN_SUPPLY_SERIES: readonly SeriesDefinition[] = [
       const resource = await loadStablecoinSupplyHistory(stablecoinSymbol(ticker!));
       const history = resource.payload.history;
       if (!history) throw new Error(`${resource.payload.symbol} supply history is not available yet.`);
-      return { points: dailyPoints(history.start, history.values), warning: cachedSeriesWarning(resource) };
+      return { points: dailyPoints(history.start, history.values), ...cachedSeriesNote(resource) };
     },
   },
 ];
@@ -63,7 +63,7 @@ const DEFI_TVL_SERIES: SeriesDefinition = {
     const resource = await loadDefiTvl();
     const history = resource.payload.history;
     if (!history) throw new Error("DeFi TVL is not available yet.");
-    return { points: dailyPoints(history.start, history.total), warning: cachedSeriesWarning(resource) };
+    return { points: dailyPoints(history.start, history.total), ...cachedSeriesNote(resource) };
   },
 };
 

package/src/plugins/builtin/debt-maturities/series.ts

@@ -1,6 +1,6 @@
 import type { DebtHistoryPoint } from "../../../api-client/debt-maturities";
 import type { SeriesDefinition } from "../../../series/types";
-import { cachedSeriesWarning } from "../shared/series-warning";
+import { cachedSeriesNote } from "../shared/series-warning";
 import { loadDebtMaturities } from "./client";
 
 type HistoryField = "totalPrincipal" | "next12MonthsShare" | "next3YearsShare";
@@ -36,10 +36,10 @@ export const DEBT_MATURITY_SERIES: readonly SeriesDefinition[] = FIELDS.map(({ i
     // An amount stays in the unit it is listed in: a filing in another currency is a gap, not a converted figure.
     const listed = (point: DebtHistoryPoint) => unit !== "USD" || point.currency === "USD";
     const other = resource.payload.history.find((point) => !listed(point))?.currency;
-    const warning = other ? `Filings reported in ${other} are left out.` : cachedSeriesWarning(resource);
     return {
       points: resource.payload.history.map((point) => ({ date: point.asOf, value: listed(point) ? point[field] : null })),
-      ...(warning ? { warning } : {}),
+      ...cachedSeriesNote(resource),
+      ...(other ? { warning: `Filings reported in ${other} are left out.` } : {}),
     };
   },
 }));

package/src/plugins/builtin/doe/client.ts

@@ -1,8 +1,8 @@
 import { apiClient } from "../../../api-client";
+import { sourceDidNotAnswer } from "../../../api-client/errors";
 import type { DoeBoardPayload, DoeSeriesRow } from "../../../api-client/doe";
-import { ApiRequestError } from "../../../api-client/errors";
 import { createPluginCache } from "../../../data/plugin-cache";
-import { cachedCloudResource, loadCloudResource } from "../shared/cloud-resource";
+import { cachedCloudResource, loadCloudResource, unavailableOnServer } from "../shared/cloud-resource";
 
 /** What the pane says while the server has no EIA weeks to serve: before the backend ships, or before its first read. */
 export const DOE_NOT_AVAILABLE = "Oil and gas inventories are not available yet.";
@@ -65,11 +65,12 @@ export async function fetchDoeBoard(client: Pick<typeof apiClient, "getCloudDoeB
   try {
     payload = await client.getCloudDoeBoard();
   } catch (error) {
-    if (error instanceof ApiRequestError && (error.status === 404 || error.status === 503)) throw new Error(DOE_NOT_AVAILABLE);
-    throw error;
+    throw unavailableOnServer(error, DOE_NOT_AVAILABLE, [404, 503]);
   }
   const board = validateDoeBoard(payload);
-  if (board.status === "unavailable" || !board.series.some((row) => row.value != null)) throw new Error(DOE_NOT_AVAILABLE);
+  // The server's source did not answer this time: a saved copy answers, as it does a 5xx.
+  if (board.status === "unavailable") throw sourceDidNotAnswer(DOE_NOT_AVAILABLE);
+  if (!board.series.some((row) => row.value != null)) throw new Error(DOE_NOT_AVAILABLE);
   return board;
 }
 

package/src/plugins/builtin/doe/prices.ts

@@ -2,7 +2,7 @@ import { apiClient } from "../../../api-client";
 import type { DoePricesPayload } from "../../../api-client/doe";
 import { createPluginCache } from "../../../data/plugin-cache";
 import type { SeriesDefinition } from "../../../series/types";
-import { cachedSeriesWarning } from "../shared/series-warning";
+import { cachedSeriesNote } from "../shared/series-warning";
 import { loadCloudResource, unavailableOnServer } from "../shared/cloud-resource";
 
 /**
@@ -73,10 +73,9 @@ export const DOE_PRICE_SERIES: readonly SeriesDefinition[] = PRICE_SERIES.map((s
     const resource = await loadCloudResource(doePriceCache, "prices", () => fetchDoePrices(), { validate: validatePrices });
     const row = resource.payload.series.find((entry) => entry.id === series.id);
     if (!row?.points.length) throw new Error(`${series.name} is not available yet.`);
-    const warning = cachedSeriesWarning(resource);
     return {
       points: row.points.map(([date, value]) => ({ date, value })),
-      ...(warning ? { warning } : {}),
+      ...cachedSeriesNote(resource),
       // Cited as the EIA series it is, not as the route that served it.
       attribution: { source: `EIA series ${series.key}`, publisher: "EIA" },
     };

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

@@ -1,6 +1,6 @@
 import type { DoeSeriesRow, DoeUnit } from "../../../api-client/doe";
 import type { SeriesDefinition, SeriesPoint } from "../../../series/types";
-import { cachedSeriesWarning } from "../shared/series-warning";
+import { cachedSeriesNote } from "../shared/series-warning";
 import { loadDoeBoard } from "./client";
 import { DOE_SERIES_OPTIONS } from "./model";
 import { DOE_PRICE_SERIES } from "./prices";
@@ -50,14 +50,14 @@ const DOE_SERIES: readonly SeriesDefinition[] = DOE_SERIES_OPTIONS.map((option):
     unit: UNITS[unit].unit,
     frequency: "weekly",
     group: "Energy",
-    tags: gas ? ["natural gas", "storage", "inventories"] : ["oil", "petroleum", "inventories", "US"],
+    // Jet fuel is kerosene, the word a reader may search it by.
+    tags: gas ? ["natural gas", "storage", "inventories"] : ["oil", "petroleum", "inventories", "US", ...option.value === "jet" ? ["kerosene"] : []],
     publisher: "EIA",
     load: async () => {
       const resource = await loadDoeBoard();
       const row = resource.payload.series.find((entry) => entry.id === option.value);
       if (!row) throw new Error(`${option.label} is not in this week's report.`);
-      const warning = cachedSeriesWarning(resource);
-      return { points: doeRowPoints(row), ...(warning ? { warning } : {}) };
+      return { points: doeRowPoints(row), ...cachedSeriesNote(resource) };
     },
   };
 });

package/src/plugins/builtin/earnings-calls/calendar.tsx

@@ -19,6 +19,8 @@ import {
   type SectionedRow,
 } from "../../../components";
 import { handleRefreshKey } from "../../../components/data-table/table-pane";
+import { savedCopyFooterInfo } from "../../../components/layout/pane/footer";
+import { isPermanentClientError } from "../../../api-client/errors";
 import { TABLE_COLUMN_GAP, tableColumnWidth } from "../../../components/ui/table-layout";
 import { useAsyncResource } from "../../../react/async-resource";
 import { useAgeClock, useAutoRefresh } from "../../../react/auto-refresh";
@@ -162,6 +164,8 @@ export function UpcomingCallsView({ focused, width, height, view, renderCompany
   }, [range]);
   const resource = useAsyncResource(entitled ? loader : null, {
     keepPreviousData: true,
+    // A refusal asking again will not change takes the calendar off screen, for its wall or its error.
+    clearOnError: isPermanentClientError,
     initialData: () => cachedUpcomingCalls(range),
   });
   const data = resource.data;
@@ -204,12 +208,16 @@ export function UpcomingCallsView({ focused, width, height, view, renderCompany
   const proRequired = !signInRequired && !verificationRequired && (!access.hasProAccess || (!data && refused === 402));
 
   const hints = useMemo<PaneHint[]>(() => [{ id: "search", key: "/", label: "search", onPress: focusSearch }], [focusSearch]);
+  // A refresh that failed shows the calendar an earlier read saved, and says when that copy is from.
+  const savedAt = data?.savedAt ?? null;
+  const savedInfo = useMemo(() => savedCopyFooterInfo([savedAt]), [savedAt]);
   usePaneStatusFooter({
     registrationId: "earnings-calls:calendar",
     enabled: !detailOpen && entitled,
     loading: resource.loading && !!data,
-    error: data ? data.refreshError ?? resource.error : null,
-    stale: !!data && (data.stale || !!resource.error),
+    error: data ? (savedAt == null ? data.refreshError : null) ?? resource.error : null,
+    stale: !!data && savedAt == null && (data.stale || !!resource.error),
+    info: savedInfo,
     hints,
   });
   // A calendar cut at the server's limit says so, rather than end the week early.

package/src/plugins/builtin/earnings-calls/data.ts

@@ -5,7 +5,7 @@ import {
   type CloudEarningsCallPayload,
   type CloudEarningsTranscriptPayload,
 } from "../../../api-client";
-import { ApiRequestError } from "../../../api-client/errors";
+import { ApiRequestError, isTransientFailure } from "../../../api-client/errors";
 import { listingAbroad, type IssuerListingParams, type ListingAbroad } from "../../../api-client/paths";
 import { servedFromSavedCopy } from "../../../data/saved-copies";
 import { areDifferentCompanies } from "../../../sources/sec-registrant";
@@ -45,6 +45,8 @@ export interface EarningsCallsResult {
   calls: CloudEarningsCallPayload[];
   fetchedAt: number;
   stale: boolean;
+  /** Its refresh failed and the copy saved at this time (ms) answered instead. */
+  savedAt?: number;
   refreshError?: string;
   /** HTTP status when the request failed, used to pick the right gate. */
   errorStatus?: number;
@@ -122,6 +124,8 @@ export interface UpcomingCallsResult {
   stale: boolean;
   /** The server answered its limit's worth: calls later on these days may be missing. */
   truncated?: boolean;
+  /** Its refresh failed and the copy saved at this time (ms) answered instead. */
+  savedAt?: number;
   refreshError?: string;
   errorStatus?: number;
 }
@@ -134,7 +138,7 @@ export interface UpcomingDays {
 let persistence: PluginPersistence | null = null;
 const activeUpcomingFetches = new Map<string, Promise<UpcomingCallsResult>>();
 const activeListFetches = new Map<string, Promise<EarningsCallsResult>>();
-const activeTranscriptFetches = new Map<string, Promise<CloudEarningsTranscriptPayload>>();
+const activeTranscriptFetches = new Map<string, Promise<EarningsTranscriptResult>>();
 
 export function attachEarningsCallsPersistence(value: PluginPersistence): void {
   persistence = value;
@@ -253,20 +257,21 @@ export async function loadEarningsCallsWithClient(
     .catch((error: unknown) => {
       const refreshError = error instanceof Error ? error.message : String(error);
       const errorStatus = statusOf(error);
-      // An auth failure must surface its gate rather than silently showing
-      // a cached list the user is no longer entitled to refresh.
+      // A refusal (signed out, no Pro, a route the server stopped serving) or a reply that fails
+      // validation is said rather than covered by a cached list.
       const expired = store?.getResource<CloudEarningsCallListPayload>(LIST_KIND, key, {
         sourceKey: CACHE_SOURCE,
         schemaVersion: LIST_CACHE_SCHEMA_VERSION,
         allowExpired: true,
       });
-      if (expired && errorStatus !== 401 && errorStatus !== 402 && errorStatus !== 403) {
+      if (expired && isTransientFailure(error)) {
         // A command that shows it ends with when the copy was saved, not with the failure.
         return servedFromSavedCopy({
           ...expired.value,
           ...sourceScope(expired.value.calls),
           fetchedAt: expired.fetchedAt,
           stale: true,
+          savedAt: expired.fetchedAt,
           refreshError,
           errorStatus,
         }, expired.fetchedAt);
@@ -367,9 +372,10 @@ export async function loadUpcomingCallsWithClient(
       const errorStatus = statusOf(error);
       // Losing Pro access re-gates the calendar, as it does the list.
       const expired = read(true);
-      if (expired && errorStatus !== 401 && errorStatus !== 402 && errorStatus !== 403) {
+      if (expired && isTransientFailure(error)) {
         return servedFromSavedCopy({
           ...upcomingFromCache(expired.value, expired.fetchedAt, true),
+          savedAt: expired.fetchedAt,
           refreshError: error instanceof Error ? error.message : String(error),
           errorStatus,
         }, expired.fetchedAt);
@@ -409,11 +415,14 @@ export function isPendingTranscript(
   return record.status === "pending" || !Array.isArray(record.turns);
 }
 
+/** A transcript, and when it was saved when its refresh failed and the saved copy answered. */
+export type EarningsTranscriptResult = CloudEarningsTranscriptPayload & { savedAt?: number };
+
 export async function loadTranscriptWithClient(
   client: EarningsCallsApiClient,
   callId: string,
   options?: { force?: boolean },
-): Promise<CloudEarningsTranscriptPayload> {
+): Promise<EarningsTranscriptResult> {
   const force = options?.force ?? false;
   const store = persistence;
 
@@ -444,7 +453,6 @@ export async function loadTranscriptWithClient(
       return transcript;
     })
     .catch((error: unknown) => {
-      const status = statusOf(error);
       const expired = store?.getResource<CloudEarningsTranscriptPayload>(
         TRANSCRIPT_KIND,
         callId,
@@ -455,8 +463,8 @@ export async function loadTranscriptWithClient(
         },
       );
       // Losing Pro access must re-gate the transcript, not serve it from cache.
-      if (expired && status !== 401 && status !== 402 && status !== 403) {
-        return expired.value;
+      if (expired && isTransientFailure(error)) {
+        return servedFromSavedCopy({ ...expired.value, savedAt: expired.fetchedAt }, expired.fetchedAt);
       }
       throw error;
     })
@@ -473,7 +481,7 @@ export async function loadTranscriptWithClient(
 export function loadTranscript(
   callId: string,
   options?: { force?: boolean },
-): Promise<CloudEarningsTranscriptPayload> {
+): Promise<EarningsTranscriptResult> {
   return loadTranscriptWithClient(apiClient, callId, options);
 }
 

package/src/plugins/builtin/earnings-calls/pane.tsx

@@ -1,8 +1,5 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-import type {
-  CloudEarningsCallPayload,
-  CloudEarningsTranscriptPayload,
-} from "../../../api-client";
+import type { CloudEarningsCallPayload } from "../../../api-client";
 import { recordResearchActivity } from "../../../api-client/research-activity";
 import {
   DataTableStackView,
@@ -49,7 +46,11 @@ import {
   loadEarningsCalls,
   loadTranscript,
   statusOf,
+  type EarningsTranscriptResult,
 } from "./data";
+import { isPermanentClientError } from "../../../api-client/errors";
+import { savedCopyFooterInfo } from "../../../components/layout/pane/footer";
+import { STALE_SEGMENT } from "../../../components/layout/pane/status-footer";
 import { callPeriod, callTitle, eventLabelOf, formatCallDate, formatDuration, formatSentiment } from "./format";
 import { findCallForQuarter, findInLines, MIN_FIND_LENGTH, turnParagraphs } from "./model";
 import { READER_TABS, TranscriptView, type ReaderTab, type TranscriptPlayback } from "./transcript-view";
@@ -148,6 +149,8 @@ interface TickerLookup {
   calls: CloudEarningsCallPayload[];
   fetchedAt?: number;
   stale?: boolean;
+  /** Its refresh failed and the copy saved at this time (ms) answered instead. */
+  savedAt?: number;
   refreshError?: string;
   refreshRequest?: number;
 }
@@ -280,6 +283,8 @@ function CallsListView({
   const [stale, setStale] = useState(initialShelf?.stale === true);
   // The company's home line the shelf is read from, for a receipt or a foreign line.
   const [companyFrom, setCompanyFrom] = useState(initialShelf?.companyFrom ?? null);
+  // The list's refresh failed and a copy saved at this time (ms) answered instead.
+  const [listSavedAt, setListSavedAt] = useState<number | null>(null);
   const [listFetchedAt, setListFetchedAt] = useState(initialShelf?.fetchedAt ?? 0);
   const listRequestVersion = useRef(0);
   const [listCompletedRequest, setListCompletedRequest] = useState(0);
@@ -292,7 +297,7 @@ function CallsListView({
 
   const [selectedId, setSelectedId] = usePluginPaneState<string | null>(`${stateKey}selectedId`, null);
   const [detailOpen, setDetailOpen] = usePluginPaneState<boolean>(`${stateKey}detailOpen`, false);
-  const [transcript, setTranscript] = useState<CloudEarningsTranscriptPayload | null>(null);
+  const [transcript, setTranscript] = useState<EarningsTranscriptResult | null>(null);
   useEffect(() => {
     if (focused && transcript && detailOpen) recordResearchActivity("pro_feature_used", "transcripts");
   }, [focused, transcript, detailOpen]);
@@ -344,10 +349,12 @@ function CallsListView({
           setHasMore(result.sourceLimitReached === true);
           setStale(result.stale);
           setCompanyFrom(result.companyFrom ?? null);
+          setListSavedAt(result.savedAt ?? null);
           setListFetchedAt(result.fetchedAt);
           setListPending(result.pending === true && result.calls.length === 0);
+          // A saved copy says when it was saved, in the footer, rather than why the refresh failed.
           setListError(
-            result.refreshError ? { message: result.refreshError, status: result.errorStatus } : null,
+            result.refreshError && result.savedAt == null ? { message: result.refreshError, status: result.errorStatus } : null,
           );
           setListStatus("loaded");
           setListCompletedRequest(request);
@@ -357,6 +364,7 @@ function CallsListView({
           setListPending(false);
           setHasMore(false);
           setNextOffset(0);
+          setListSavedAt(null);
           setListError({
             message: error instanceof Error ? error.message : String(error),
             status: statusOf(error),
@@ -415,6 +423,7 @@ function CallsListView({
     setListPending(held?.pending === true && held.calls.length === 0);
     setStale(held?.stale === true);
     setCompanyFrom(held?.companyFrom ?? null);
+    setListSavedAt(null);
     setListFetchedAt(held?.fetchedAt ?? 0);
     setListError(null);
     setLookup(null);
@@ -482,19 +491,22 @@ function CallsListView({
             calls: result.calls,
             fetchedAt: result.fetchedAt,
             stale: result.stale,
-            refreshError: result.refreshError,
+            savedAt: result.savedAt,
+            refreshError: result.savedAt == null ? result.refreshError : undefined,
             refreshRequest,
           });
         })
         .catch((error: unknown) => {
           if (cancelled) return;
-          const retainRows = ![401, 402, 403].includes(statusOf(error) ?? 0);
+          // A refusal asking again will not change clears the rows; a passing failure keeps them.
+          const retainRows = !isPermanentClientError(error);
           setLookup((current) => ({
             ticker: lookupTicker,
             status: "error",
             calls: retainRows && current?.ticker === lookupTicker ? current.calls : [],
             fetchedAt: retainRows && current?.ticker === lookupTicker ? current.fetchedAt : undefined,
             stale: retainRows && current?.ticker === lookupTicker && current.calls.length > 0,
+            savedAt: retainRows && current?.ticker === lookupTicker ? current.savedAt : undefined,
             refreshError: error instanceof Error ? error.message : String(error),
             refreshRequest,
           }));
@@ -864,15 +876,14 @@ function CallsListView({
         }
       }
       const visibleLookup = lookup && (lookup.ticker === lookupTicker || (detailOpen && selected?.ticker === lookup.ticker)) ? lookup : null;
-      if (visibleLookup?.stale) {
-        info.push({ id: "lookup-stale", parts: [{ text: `${visibleLookup.ticker} stale cache`, tone: "warning" }] });
-      }
       if (visibleLookup?.refreshError && lookupState !== "error") {
         info.push({ id: "lookup-error", parts: [{ text: `${visibleLookup.ticker}: ${visibleLookup.refreshError}`, tone: "warning" }] });
       }
-      if (stale) {
-        info.push({ id: "stale", parts: [{ text: "stale cache", tone: "warning" }] });
-      }
+      // What a failed refresh left on screen: a saved copy says when it was saved; a list
+      // held from an earlier session, still refreshing, is only stale.
+      const savedCopy = savedCopyFooterInfo([listSavedAt, visibleLookup?.savedAt, readerOpen ? selectedTranscript?.savedAt : null]);
+      info.push(...savedCopy);
+      if (stale && listSavedAt == null) info.push(STALE_SEGMENT);
       if (listError) {
         info.push({ id: "error", parts: [{ text: listError.message, tone: "warning" }] });
       }
@@ -911,6 +922,8 @@ function CallsListView({
       lookupTicker,
       lookup,
       stale,
+      listSavedAt,
+      selectedTranscript,
       listError,
       proRequired,
       transcriptProRequired,

package/src/plugins/builtin/econ/detail-view.tsx

@@ -18,6 +18,8 @@ import {
   type StatItem,
 } from "../../../components";
 import { spanDigits } from "../../../components/chart-table";
+import { savedCopyFooterInfo } from "../../../components/layout/pane/footer";
+import { isPermanentClientError } from "../../../api-client/errors";
 import { getTableWidth, hasMeaningfulTableHorizontalOverflow } from "../../../components/ui/table-layout";
 import type { CompositeAxisDomain } from "../../../components/chart/composite/types";
 import {
@@ -123,6 +125,8 @@ export function EconDetailView({ event, width, height, focused }: EconDetailView
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState<string | null>(null);
   const [freshnessWarning, setFreshnessWarning] = useState<string | null>(null);
+  // The history's refresh failed and the copy saved at this time (ms) answered instead.
+  const [savedAt, setSavedAt] = useState<number | null>(null);
   const [data, setData] = useState<FredSeriesData | null>(null);
   // Null follows the latest period.
   const [selectedDate, setSelectedDate] = useState<string | null>(null);
@@ -146,6 +150,7 @@ export function EconDetailView({ event, width, height, focused }: EconDetailView
       setLoading(false);
       setError(null);
       setFreshnessWarning(null);
+      setSavedAt(null);
       return;
     }
 
@@ -156,6 +161,7 @@ export function EconDetailView({ event, width, height, focused }: EconDetailView
         setLoading(false);
         setError(null);
         setFreshnessWarning(null);
+        setSavedAt(null);
         return;
       }
     } else {
@@ -165,6 +171,7 @@ export function EconDetailView({ event, width, height, focused }: EconDetailView
     setLoading(true);
     setError(null);
     setFreshnessWarning(null);
+    setSavedAt(null);
 
     loadCachedFredSeries(
       request,
@@ -174,12 +181,18 @@ export function EconDetailView({ event, width, height, focused }: EconDetailView
       }),
     )
       .then((entry) => {
+        // A refusal or a reply that fails validation is thrown by the load, never covered by a saved copy.
+        const saved = entry.source === "stale-fallback";
         setData(entry.data);
-        setFreshnessWarning(entry.stale
-          ? `Cached ${new Date(entry.fetchedAt).toISOString().slice(0, 10)} · refresh failed`
+        // A copy a failed refresh left says when it was saved, in the footer as every pane does;
+        // a series its source has not updated since is a note.
+        setSavedAt(saved ? entry.fetchedAt : null);
+        setFreshnessWarning(entry.stale && !saved
+          ? `Source not updated since ${new Date(entry.fetchedAt).toISOString().slice(0, 10)}.`
           : null);
       })
       .catch((err) => {
+        if (isPermanentClientError(err)) setData(null);
         setError(err instanceof Error ? err.message : String(err));
       })
       .finally(() => {
@@ -199,6 +212,7 @@ export function EconDetailView({ event, width, height, focused }: EconDetailView
   // which asks which one when there are several.
   const openTickerChoice = useOpenTickerChoice();
   const relatedTickers = useMemo(() => mapping?.relatedTickers ?? [], [mapping]);
+  usePaneFooter("econ-detail:saved", () => ({ info: savedCopyFooterInfo([savedAt]) }), [savedAt]);
   usePaneFooter("econ-detail:related", () => relatedTickers.length > 0 ? {
     hints: [{
       id: "related",

package/src/plugins/builtin/executives/data.ts

@@ -3,7 +3,7 @@ import {
   type CloudProxyStatementListPayload,
   type CloudProxyStatementPayload,
 } from "../../../api-client";
-import { ApiRequestError, isPermanentClientError } from "../../../api-client/errors";
+import { ApiRequestError, isPermanentClientError, isTransientFailure } from "../../../api-client/errors";
 import type { IssuerListingParams } from "../../../api-client/paths";
 import type { PluginPersistence } from "../../../types/plugin";
 import { secListingKey } from "../../../utils/sec";
@@ -46,6 +46,8 @@ interface ProxyResult<T> {
   /** Null is an explicit 404, not a transient failure or access denial. */
   data: T | null;
   fetchedAt: number | null;
+  /** Its refresh failed and the copy saved at this time (ms) answered instead. */
+  savedAt?: number;
   refreshError?: string;
 }
 type ActiveRequest<T> = { store: PluginPersistence | null; promise: Promise<ProxyResult<T>> };
@@ -105,11 +107,14 @@ function loadCached<T>(
       }
       throw error;
     }
+    // A saved copy answers only for a failure asking again may get past, not for a reply that fails validation.
+    if (!isTransientFailure(error)) throw error;
     const fallback = store?.getResource<T>(kind, key, { ...options, allowExpired: true });
     if (!fallback || tierOf(fallback.value) !== tier) throw error;
     return {
       data: fallback.value,
       fetchedAt: fallback.fetchedAt,
+      savedAt: fallback.fetchedAt,
       refreshError: (error instanceof Error ? error.message : String(error)).trim() || "Request failed",
     };
   }).finally(() => { if (active.get(activeKey) === request) active.delete(activeKey); });