@sybilion/uilib 1.3.79 → 1.3.81

package/dist/esm/components/ui/Chat/ChatChrome/ChatChrome.js

@@ -10,6 +10,7 @@ import { DropZone } from '../../DropZone/DropZone.js';
 import { PanelResizeHandle } from '../../Sidebar/Sidebar.js';
 import SidebarStem from '../../Sidebar/Sidebar.styl.js';
 import { Chat } from '../Chat.js';
+import { MessageRole } from '../Chat.types.js';
 import { filterToTextAttachments, isAttachmentsDropzoneEnabled, buildAcceptAttr } from '../chatAttachmentAccept.js';
 import { extractChatAttachmentItems } from '../chatAttachmentExtract.js';
 import S from './ChatChrome.styl.js';
@@ -21,6 +22,7 @@ function ChatChrome({ showResizeHandle, resizeHandle, onClose, isEmpty, renderPr
     const [pendingAttachments, setPendingAttachments] = useState([]);
     const [isExtractingAttachments, setIsExtractingAttachments] = useState(false);
     const promptDisabled = isExtractingAttachments;
+    const hasInProgressSystemMessage = useMemo(() => messages.some(msg => msg.role === MessageRole.SYSTEM && msg.inProgress === true), [messages]);
     const handleAttachmentFiles = useCallback((files) => {
         if (promptDisabled || files.length === 0)
             return;
@@ -85,7 +87,9 @@ function ChatChrome({ showResizeHandle, resizeHandle, onClose, isEmpty, renderPr
                                                 const label = displayLabelForBranchKeyFromMessages(key, messages) ??
                                                     humanizeBranchKey(key);
                                                 return (jsx("span", { className: S.branchBtnWrap, children: jsxs(Button, { type: "button", variant: "outline", size: "sm", disabled: isLoading, onClick: () => onQuickReply(key, label), children: [jsx(PaperPlaneRightIcon, {}), label] }) }, key));
-                                            }) })) : null, showInlinePresets && renderPresets('inline'), isLoading && (isLastMessageFromUser || loadingLabel) && (jsx(TextShimmer, { duration: 1, spread: 5, className: S.loader, children: loadingLabel ?? 'Thinking...' }))] }) })), isEmpty ? (jsx("div", { className: S.fixedPresets, children: renderPresets('fixed') })) : null, jsxs("div", { className: cn(S.footer, footerClassName), children: [isEmpty ? (jsx("div", { className: S.notice, children: "Forecast Assistant can make mistakes." })) : null, jsx(Chat.Prompt, { onSubmit: handlePromptSubmitWithAttachments, disabled: promptDisabled, attachments: pendingAttachments, onRemoveAttachment: handleRemoveAttachment, prefillMessage: promptPrefill ?? undefined, placeholder: promptPlaceholder, slashCommandItems: slashCommandItems, onSlashItemCommand: onSlashItemCommand, attachmentAccept: attachmentsDropzoneEnabled ? attachmentAccept : undefined, onAttachmentFiles: attachmentsDropzoneEnabled ? handleAttachmentFiles : undefined })] })] })] })] }));
+                                            }) })) : null, showInlinePresets && renderPresets('inline'), isLoading &&
+                                            !hasInProgressSystemMessage &&
+                                            (isLastMessageFromUser || loadingLabel) && (jsx(TextShimmer, { duration: 1, spread: 5, className: S.loader, children: loadingLabel ?? 'Thinking...' }))] }) })), isEmpty ? (jsx("div", { className: S.fixedPresets, children: renderPresets('fixed') })) : null, jsxs("div", { className: cn(S.footer, footerClassName), children: [isEmpty ? (jsx("div", { className: S.notice, children: "Forecast Assistant can make mistakes." })) : null, jsx(Chat.Prompt, { onSubmit: handlePromptSubmitWithAttachments, disabled: promptDisabled, attachments: pendingAttachments, onRemoveAttachment: handleRemoveAttachment, prefillMessage: promptPrefill ?? undefined, placeholder: promptPlaceholder, slashCommandItems: slashCommandItems, onSlashItemCommand: onSlashItemCommand, attachmentAccept: attachmentsDropzoneEnabled ? attachmentAccept : undefined, onAttachmentFiles: attachmentsDropzoneEnabled ? handleAttachmentFiles : undefined })] })] })] })] }));
 }
 
 export { ChatChrome };

package/dist/esm/components/ui/Chat/buildChatSendMessagePayload.js

@@ -68,7 +68,9 @@ function displayTextFromSendPayload(message) {
 }
 /** Optional loading shimmer label from a structured send payload. */
 function loadingLabelFromSendPayload(message) {
-    return typeof message === 'string' ? undefined : message.loadingLabel;
+    if (typeof message === 'string')
+        return undefined;
+    return message.loadingLabel ?? message.systemProgressLabel;
 }
 
 export { buildChatSendMessagePayload, displayTextFromSendPayload, loadingLabelFromSendPayload, normalizeUserTextFileAttachments };

package/dist/esm/components/widgets/DriversComparisonChart/driversComparisonChart.helpers.js

@@ -97,12 +97,14 @@ function shiftNormalizedSeriesBackward(series, lagMonths) {
 function applyDriversComparisonViewToPayload(payload, tab) {
     if (!payload || tab === 'lagged')
         return payload;
+    if (!payload.target?.normalized_series)
+        return payload;
     return {
         target: {
             ...payload.target,
             normalized_series: { ...payload.target.normalized_series },
         },
-        drivers: payload.drivers.map(driver => {
+        drivers: (payload.drivers ?? []).map(driver => {
             const lagMonths = parseLagMonthsFromLabel(resolveDriverLagLabel(driver));
             const series = driver.normalized_series ?? {};
             const normalized_series = lagMonths != null && lagMonths > 0

package/dist/esm/contexts/chat-context.js

@@ -4,6 +4,7 @@ import { MessageRole } from '../components/ui/Chat/Chat.types.js';
 import { normalizeUserTextFileAttachments } from '../components/ui/Chat/buildChatSendMessagePayload.js';
 import { stripJsonDashboardFences } from '../lib/dashboard-spec/stripJsonDashboardFences.js';
 import { LS } from '@homecode/ui';
+import { persistChatsToLS, safeLsSet } from './chatPersistence.js';
 
 const CHATS_PREFIX = 'chats-';
 const CHAT_SCOPE_IDS_REGISTRY_KEY = 'chat-scope-ids';
@@ -77,7 +78,7 @@ function addScopeIdToRegistry(scopeId) {
     const raw = LS.get(CHAT_SCOPE_IDS_REGISTRY_KEY);
     const registry = Array.isArray(raw) ? [...raw] : [];
     if (!registry.includes(scopeId)) {
-        LS.set(CHAT_SCOPE_IDS_REGISTRY_KEY, [...registry, scopeId]);
+        safeLsSet(CHAT_SCOPE_IDS_REGISTRY_KEY, [...registry, scopeId]);
     }
 }
 /** Shallow-clone messages for seeding another session; drops in-progress rows. */
@@ -155,25 +156,23 @@ function ChatProvider({ children, userSwitchKey, sendChatMessage: sendChatMessag
         setChats(prev => {
             const currentChats = prev[scopeId] ?? [];
             const updatedChats = [newChat, ...currentChats];
-            const chatsKey = getChatsKey(scopeId);
-            LS.set(chatsKey, updatedChats);
+            persistChatsToLS(scopeId, updatedChats);
             return {
                 ...prev,
                 [scopeId]: updatedChats,
             };
         });
         setCurrentChatIdState(prev => ({ ...prev, [scopeId]: sessionId }));
-        LS.set(getCurrentChatIdKey(scopeId), sessionId);
+        safeLsSet(getCurrentChatIdKey(scopeId), sessionId);
         return sessionId;
     }, [userSwitchKey]);
     const setCurrentChatId = useCallback((currScopeId, sessionId) => {
         if (!sessionId)
             return;
         setCurrentChatIdState(prev => ({ ...prev, [currScopeId]: sessionId }));
-        LS.set(getCurrentChatIdKey(currScopeId), sessionId);
+        safeLsSet(getCurrentChatIdKey(currScopeId), sessionId);
     }, []);
     const deleteChat = useCallback((scopeId, sessionId) => {
-        const chatsKey = getChatsKey(scopeId);
         const currentKey = getCurrentChatIdKey(scopeId);
         setChats(prev => {
             const scopeChats = prev[scopeId] ?? [];
@@ -182,7 +181,7 @@ function ChatProvider({ children, userSwitchKey, sendChatMessage: sendChatMessag
                 return prev;
             }
             const updatedChats = scopeChats.filter(c => c.session_id !== sessionId);
-            LS.set(chatsKey, updatedChats);
+            persistChatsToLS(scopeId, updatedChats);
             setCurrentChatIdState(prevCurr => {
                 if (prevCurr[scopeId] !== sessionId) {
                     return prevCurr;
@@ -191,7 +190,7 @@ function ChatProvider({ children, userSwitchKey, sendChatMessage: sendChatMessag
                     ? scopeChats[deletedIndex - 1].session_id
                     : (updatedChats[0]?.session_id ?? null);
                 if (nextId) {
-                    LS.set(currentKey, nextId);
+                    safeLsSet(currentKey, nextId);
                 }
                 else {
                     LS.remove(currentKey);
@@ -228,8 +227,7 @@ function ChatProvider({ children, userSwitchKey, sendChatMessage: sendChatMessag
                 }
                 return chat;
             });
-            const chatsKey = getChatsKey(scopeId);
-            LS.set(chatsKey, updatedChats);
+            persistChatsToLS(scopeId, updatedChats);
             return { ...prev, [scopeId]: updatedChats };
         });
         return newMessage.id;
@@ -247,8 +245,7 @@ function ChatProvider({ children, userSwitchKey, sendChatMessage: sendChatMessag
                     messages: chat.messages.filter(m => m.id !== messageId),
                 };
             });
-            const chatsKey = getChatsKey(scopeId);
-            LS.set(chatsKey, updatedChats);
+            persistChatsToLS(scopeId, updatedChats);
             return { ...prev, [scopeId]: updatedChats };
         });
     }, [userSwitchKey]);
@@ -286,8 +283,7 @@ function ChatProvider({ children, userSwitchKey, sendChatMessage: sendChatMessag
                     }),
                 };
             });
-            const chatsKey = getChatsKey(scopeId);
-            LS.set(chatsKey, updatedChats);
+            persistChatsToLS(scopeId, updatedChats);
             return { ...prev, [scopeId]: updatedChats };
         });
     }, [userSwitchKey]);
@@ -306,8 +302,7 @@ function ChatProvider({ children, userSwitchKey, sendChatMessage: sendChatMessag
                     return chat;
                 return { ...chat, messages: cloned };
             });
-            const chatsKey = getChatsKey(scopeId);
-            LS.set(chatsKey, updatedChats);
+            persistChatsToLS(scopeId, updatedChats);
             return { ...prev, [scopeId]: updatedChats };
         });
     }, [userSwitchKey]);
@@ -324,8 +319,7 @@ function ChatProvider({ children, userSwitchKey, sendChatMessage: sendChatMessag
                     meta: { ...chat.meta, ...patch },
                 };
             });
-            const chatsKey = getChatsKey(scopeId);
-            LS.set(chatsKey, updatedChats);
+            persistChatsToLS(scopeId, updatedChats);
             return { ...prev, [scopeId]: updatedChats };
         });
     }, [userSwitchKey]);
@@ -343,33 +337,45 @@ function ChatProvider({ children, userSwitchKey, sendChatMessage: sendChatMessag
                 userTextFileAttachments: normalizeUserTextFileAttachments(message),
             });
         }
+        let progressMessageId;
+        if (typeof message !== 'string' && message.systemProgressLabel) {
+            progressMessageId = addMessage(scopeId, targetChatId, MessageRole.SYSTEM, message.systemProgressLabel, { inProgress: true });
+        }
         const pendingChatSessionId = targetChatId;
         beginOutboundPending(scopeId, pendingChatSessionId);
+        let effectiveSessionId = pendingChatSessionId;
         try {
             const data = await sendChatMessageFn(apiPayload, pendingChatSessionId);
-            const effectiveSessionId = data.session_id && data.session_id !== pendingChatSessionId
-                ? data.session_id
-                : pendingChatSessionId;
+            effectiveSessionId =
+                data.session_id && data.session_id !== pendingChatSessionId
+                    ? data.session_id
+                    : pendingChatSessionId;
             if (data.session_id && data.session_id !== pendingChatSessionId) {
                 setChats(prev => {
                     const scopeChats = prev[scopeId] ?? [];
                     const updatedChats = scopeChats.map(chat => chat.session_id === pendingChatSessionId
                         ? { ...chat, session_id: data.session_id }
                         : chat);
-                    const chatsKey = getChatsKey(scopeId);
-                    LS.set(chatsKey, updatedChats);
+                    persistChatsToLS(scopeId, updatedChats);
                     return { ...prev, [scopeId]: updatedChats };
                 });
                 setCurrentChatId(scopeId, data.session_id);
             }
+            if (progressMessageId) {
+                removeMessageById(scopeId, effectiveSessionId, progressMessageId);
+                progressMessageId = undefined;
+            }
             addMessage(scopeId, effectiveSessionId, MessageRole.ASSISTANT, data.response);
             return { response: data.response, sessionId: effectiveSessionId };
         }
         catch (error) {
+            if (progressMessageId) {
+                removeMessageById(scopeId, effectiveSessionId, progressMessageId);
+            }
             const errorMessage = error instanceof Error
                 ? error.message
                 : 'Sorry, I encountered an error processing your message. Please try again.';
-            addMessage(scopeId, pendingChatSessionId, MessageRole.ASSISTANT, errorMessage);
+            addMessage(scopeId, effectiveSessionId, MessageRole.ASSISTANT, errorMessage);
             throw error;
         }
         finally {
@@ -377,6 +383,7 @@ function ChatProvider({ children, userSwitchKey, sendChatMessage: sendChatMessag
         }
     }, [
         addMessage,
+        removeMessageById,
         beginOutboundPending,
         endOutboundPending,
         getCurrentChatId,

package/dist/esm/contexts/chatPersistence.js

@@ -0,0 +1,67 @@
+import { stripJsonDashboardFences } from '../lib/dashboard-spec/stripJsonDashboardFences.js';
+import { LS } from '@homecode/ui';
+
+/** Ephemeral scopes (e.g. /reports/new draft) — keep only the latest session in LS. */
+const EPHEMERAL_SCOPE_MARKERS = ['__reports_new_draft__'];
+function isEphemeralChatScope(scopeId) {
+    return EPHEMERAL_SCOPE_MARKERS.some(marker => scopeId.endsWith(marker));
+}
+function isQuotaExceededError(error) {
+    if (!(error instanceof DOMException))
+        return false;
+    return (error.name === 'QuotaExceededError' ||
+        error.code === 22 ||
+        error.code === 1014);
+}
+function stripAttachmentForPersistence(attachment) {
+    return {
+        displayName: attachment.displayName,
+        filename: attachment.filename,
+        content: '',
+    };
+}
+function stripMessageForPersistence(message) {
+    const text = stripJsonDashboardFences(message.text);
+    const next = { ...message, text };
+    if (message.inProgress) {
+        delete next.inProgress;
+    }
+    if (message.userTextFileAttachments?.length) {
+        next.userTextFileAttachments = message.userTextFileAttachments.map(stripAttachmentForPersistence);
+    }
+    return next;
+}
+function stripChatsForPersistence(chats) {
+    return chats.map(chat => ({
+        ...chat,
+        messages: chat.messages
+            .filter(message => !message.inProgress)
+            .map(stripMessageForPersistence),
+    }));
+}
+function chatsForScopePersistence(scopeId, chats) {
+    const scopeChats = isEphemeralChatScope(scopeId) ? chats.slice(0, 1) : chats;
+    return stripChatsForPersistence(scopeChats);
+}
+function persistChatsToLS(scopeId, chats) {
+    const chatsKey = `chats-${scopeId}`;
+    const payload = chatsForScopePersistence(scopeId, chats);
+    try {
+        LS.set(chatsKey, payload);
+    }
+    catch (error) {
+        if (!isQuotaExceededError(error))
+            throw error;
+    }
+}
+function safeLsSet(key, value) {
+    try {
+        LS.set(key, value);
+    }
+    catch (error) {
+        if (!isQuotaExceededError(error))
+            throw error;
+    }
+}
+
+export { persistChatsToLS, safeLsSet, stripChatsForPersistence, stripMessageForPersistence };

package/dist/esm/types/src/components/ui/Chat/Chat.types.d.ts

@@ -21,6 +21,8 @@ export type ChatSendMessagePayload = {
     omitUserMessage?: boolean;
     /** Shimmer label while waiting on the API; defaults to "Thinking...". */
     loadingLabel?: string;
+    /** When set, show as a SYSTEM inProgress bubble instead of the footer shimmer. */
+    systemProgressLabel?: string;
 };
 export type ChatMetaValue = string | number | boolean | null;
 export type ChatMeta = Record<string, ChatMetaValue>;

package/dist/esm/types/src/contexts/chatPersistence.d.ts

@@ -0,0 +1,5 @@
+import type { Chat, Message } from '#uilib/components/ui/Chat/Chat.types';
+export declare function stripMessageForPersistence(message: Message): Message;
+export declare function stripChatsForPersistence(chats: Chat[]): Chat[];
+export declare function persistChatsToLS(scopeId: string, chats: Chat[]): void;
+export declare function safeLsSet(key: string, value: unknown): void;

package/dist/esm/types/src/contexts/chatPersistence.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/types/tests/mocks/homecodeUiMock.d.ts

@@ -0,0 +1,6 @@
+declare const LS: {
+    get(key: string): any;
+    set(key: string, val: unknown): void;
+    remove(key: string): void;
+};
+export { LS };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sybilion/uilib",
-  "version": "1.3.79",
+  "version": "1.3.81",
   "description": "Sybilion Design System — React UI components (Webpack + Stylus)",
   "publishConfig": {
     "access": "public",

package/src/components/ui/Chat/Chat.types.ts

@@ -29,6 +29,8 @@ export type ChatSendMessagePayload = {
   omitUserMessage?: boolean;
   /** Shimmer label while waiting on the API; defaults to "Thinking...". */
   loadingLabel?: string;
+  /** When set, show as a SYSTEM inProgress bubble instead of the footer shimmer. */
+  systemProgressLabel?: string;
 };
 
 export type ChatMetaValue = string | number | boolean | null;

package/src/components/ui/Chat/ChatChrome/ChatChrome.tsx

@@ -14,7 +14,7 @@ import { DropZone } from '../../DropZone/DropZone';
 import { PanelResizeHandle } from '../../Sidebar/Sidebar';
 import SidebarStem from '../../Sidebar/Sidebar.styl';
 import { Chat } from '../Chat';
-import type { ChatAttachmentDropItem } from '../Chat.types';
+import { type ChatAttachmentDropItem, MessageRole } from '../Chat.types';
 import {
   buildAcceptAttr,
   filterToTextAttachments,
@@ -76,6 +76,13 @@ export function ChatChrome({
   >([]);
   const [isExtractingAttachments, setIsExtractingAttachments] = useState(false);
   const promptDisabled = isExtractingAttachments;
+  const hasInProgressSystemMessage = useMemo(
+    () =>
+      messages.some(
+        msg => msg.role === MessageRole.SYSTEM && msg.inProgress === true,
+      ),
+    [messages],
+  );
 
   const handleAttachmentFiles = useCallback(
     (files: File[]) => {
@@ -263,11 +270,13 @@ export function ChatChrome({
 
                 {showInlinePresets && renderPresets('inline')}
 
-                {isLoading && (isLastMessageFromUser || loadingLabel) && (
-                  <TextShimmer duration={1} spread={5} className={S.loader}>
-                    {loadingLabel ?? 'Thinking...'}
-                  </TextShimmer>
-                )}
+                {isLoading &&
+                  !hasInProgressSystemMessage &&
+                  (isLastMessageFromUser || loadingLabel) && (
+                    <TextShimmer duration={1} spread={5} className={S.loader}>
+                      {loadingLabel ?? 'Thinking...'}
+                    </TextShimmer>
+                  )}
               </Scroll>
             </div>
           )}

package/src/components/ui/Chat/buildChatSendMessagePayload.ts

@@ -85,5 +85,6 @@ export function displayTextFromSendPayload(
 export function loadingLabelFromSendPayload(
   message: string | ChatSendMessagePayload,
 ): string | undefined {
-  return typeof message === 'string' ? undefined : message.loadingLabel;
+  if (typeof message === 'string') return undefined;
+  return message.loadingLabel ?? message.systemProgressLabel;
 }

package/src/components/widgets/DriversComparisonChart/driversComparisonChart.helpers.test.ts

@@ -127,7 +127,16 @@ describe('applyDriversComparisonViewToPayload', () => {
   };
 
   it('returns original payload for lagged tab', () => {
-    expect(applyDriversComparisonViewToPayload(payload, 'lagged')).toBe(payload);
+    expect(applyDriversComparisonViewToPayload(payload, 'lagged')).toBe(
+      payload,
+    );
+  });
+
+  it('returns original payload for overlapped tab when target series missing', () => {
+    const incomplete = { drivers: payload.drivers } as typeof payload;
+    expect(applyDriversComparisonViewToPayload(incomplete, 'overlapped')).toBe(
+      incomplete,
+    );
   });
 
   it('shifts driver series backward for overlapped tab without mutating source', () => {
@@ -253,6 +262,9 @@ describe('buildDriversComparisonChartData historical window floor', () => {
   };
 
   const datasetHistorical: ChartDataPoint[] = [
+    { date: '2014-07-01', historical: 97 },
+    { date: '2014-08-01', historical: 98 },
+    { date: '2014-09-01', historical: 99 },
     { date: '2014-10-01', historical: 100 },
     { date: '2014-11-01', historical: 101 },
     { date: '2014-12-01', historical: 102 },
@@ -327,8 +339,8 @@ describe('buildDriversComparisonChartData historical window floor', () => {
 
     expect(laggedChart[0]?.date).toBe('2014-10-01');
     expect(overlappedChart[0]?.date).toBe('2014-07-01');
-    expect(
-      overlappedChart[0]?.date!.localeCompare(laggedChart[0]?.date!),
-    ).toBe(-1);
+    expect(overlappedChart[0]?.date!.localeCompare(laggedChart[0]?.date!)).toBe(
+      -1,
+    );
   });
 });

package/src/components/widgets/DriversComparisonChart/driversComparisonChart.helpers.ts

@@ -125,13 +125,14 @@ export function applyDriversComparisonViewToPayload(
   tab: DriversComparisonViewTab,
 ): BacktestsComponentPayload | null {
   if (!payload || tab === 'lagged') return payload;
+  if (!payload.target?.normalized_series) return payload;
 
   return {
     target: {
       ...payload.target,
       normalized_series: { ...payload.target.normalized_series },
     },
-    drivers: payload.drivers.map(driver => {
+    drivers: (payload.drivers ?? []).map(driver => {
       const lagMonths = parseLagMonthsFromLabel(resolveDriverLagLabel(driver));
       const series = driver.normalized_series ?? {};
       const normalized_series =

package/src/contexts/chat-context.tsx

@@ -21,6 +21,8 @@ import { stripJsonDashboardFences } from '#uilib/lib/dashboard-spec/stripJsonDas
 import type { ChatResponse } from '#uilib/types/chat-api.types';
 import { LS } from '@homecode/ui';
 
+import { persistChatsToLS, safeLsSet } from './chatPersistence';
+
 export type SendChatMessageFn = (
   message: string,
   targetChatId: string,
@@ -184,7 +186,7 @@ function addScopeIdToRegistry(scopeId: string) {
   const raw = LS.get(CHAT_SCOPE_IDS_REGISTRY_KEY);
   const registry = Array.isArray(raw) ? [...raw] : [];
   if (!registry.includes(scopeId)) {
-    LS.set(CHAT_SCOPE_IDS_REGISTRY_KEY, [...registry, scopeId]);
+    safeLsSet(CHAT_SCOPE_IDS_REGISTRY_KEY, [...registry, scopeId]);
   }
 }
 
@@ -300,8 +302,7 @@ export function ChatProvider({
         const currentChats = prev[scopeId] ?? [];
         const updatedChats = [newChat, ...currentChats];
 
-        const chatsKey = getChatsKey(scopeId);
-        LS.set(chatsKey, updatedChats);
+        persistChatsToLS(scopeId, updatedChats);
 
         return {
           ...prev,
@@ -309,7 +310,7 @@ export function ChatProvider({
         };
       });
       setCurrentChatIdState(prev => ({ ...prev, [scopeId]: sessionId }));
-      LS.set(getCurrentChatIdKey(scopeId), sessionId);
+      safeLsSet(getCurrentChatIdKey(scopeId), sessionId);
       return sessionId;
     },
     [userSwitchKey],
@@ -319,13 +320,12 @@ export function ChatProvider({
     (currScopeId: string, sessionId: string) => {
       if (!sessionId) return;
       setCurrentChatIdState(prev => ({ ...prev, [currScopeId]: sessionId }));
-      LS.set(getCurrentChatIdKey(currScopeId), sessionId);
+      safeLsSet(getCurrentChatIdKey(currScopeId), sessionId);
     },
     [],
   );
 
   const deleteChat = useCallback((scopeId: string, sessionId: string) => {
-    const chatsKey = getChatsKey(scopeId);
     const currentKey = getCurrentChatIdKey(scopeId);
 
     setChats(prev => {
@@ -337,7 +337,7 @@ export function ChatProvider({
         return prev;
       }
       const updatedChats = scopeChats.filter(c => c.session_id !== sessionId);
-      LS.set(chatsKey, updatedChats);
+      persistChatsToLS(scopeId, updatedChats);
 
       setCurrentChatIdState(prevCurr => {
         if (prevCurr[scopeId] !== sessionId) {
@@ -348,7 +348,7 @@ export function ChatProvider({
             ? scopeChats[deletedIndex - 1].session_id
             : (updatedChats[0]?.session_id ?? null);
         if (nextId) {
-          LS.set(currentKey, nextId);
+          safeLsSet(currentKey, nextId);
         } else {
           LS.remove(currentKey);
         }
@@ -395,8 +395,7 @@ export function ChatProvider({
           return chat;
         });
 
-        const chatsKey = getChatsKey(scopeId);
-        LS.set(chatsKey, updatedChats);
+        persistChatsToLS(scopeId, updatedChats);
 
         return { ...prev, [scopeId]: updatedChats };
       });
@@ -417,8 +416,7 @@ export function ChatProvider({
             messages: chat.messages.filter(m => m.id !== messageId),
           };
         });
-        const chatsKey = getChatsKey(scopeId);
-        LS.set(chatsKey, updatedChats);
+        persistChatsToLS(scopeId, updatedChats);
         return { ...prev, [scopeId]: updatedChats };
       });
     },
@@ -463,8 +461,7 @@ export function ChatProvider({
             }),
           };
         });
-        const chatsKey = getChatsKey(scopeId);
-        LS.set(chatsKey, updatedChats);
+        persistChatsToLS(scopeId, updatedChats);
         return { ...prev, [scopeId]: updatedChats };
       });
     },
@@ -487,8 +484,7 @@ export function ChatProvider({
           return { ...chat, messages: cloned };
         });
 
-        const chatsKey = getChatsKey(scopeId);
-        LS.set(chatsKey, updatedChats);
+        persistChatsToLS(scopeId, updatedChats);
 
         return { ...prev, [scopeId]: updatedChats };
       });
@@ -509,8 +505,7 @@ export function ChatProvider({
           };
         });
 
-        const chatsKey = getChatsKey(scopeId);
-        LS.set(chatsKey, updatedChats);
+        persistChatsToLS(scopeId, updatedChats);
 
         return { ...prev, [scopeId]: updatedChats };
       });
@@ -546,12 +541,24 @@ export function ChatProvider({
         );
       }
 
+      let progressMessageId: string | undefined;
+      if (typeof message !== 'string' && message.systemProgressLabel) {
+        progressMessageId = addMessage(
+          scopeId,
+          targetChatId,
+          MessageRole.SYSTEM,
+          message.systemProgressLabel,
+          { inProgress: true },
+        );
+      }
+
       const pendingChatSessionId = targetChatId;
       beginOutboundPending(scopeId, pendingChatSessionId);
+      let effectiveSessionId = pendingChatSessionId;
       try {
         const data = await sendChatMessageFn(apiPayload, pendingChatSessionId);
 
-        const effectiveSessionId =
+        effectiveSessionId =
           data.session_id && data.session_id !== pendingChatSessionId
             ? data.session_id
             : pendingChatSessionId;
@@ -565,14 +572,18 @@ export function ChatProvider({
                 : chat,
             );
 
-            const chatsKey = getChatsKey(scopeId);
-            LS.set(chatsKey, updatedChats);
+            persistChatsToLS(scopeId, updatedChats);
 
             return { ...prev, [scopeId]: updatedChats };
           });
           setCurrentChatId(scopeId, data.session_id);
         }
 
+        if (progressMessageId) {
+          removeMessageById(scopeId, effectiveSessionId, progressMessageId);
+          progressMessageId = undefined;
+        }
+
         addMessage(
           scopeId,
           effectiveSessionId,
@@ -582,6 +593,10 @@ export function ChatProvider({
 
         return { response: data.response, sessionId: effectiveSessionId };
       } catch (error) {
+        if (progressMessageId) {
+          removeMessageById(scopeId, effectiveSessionId, progressMessageId);
+        }
+
         const errorMessage =
           error instanceof Error
             ? error.message
@@ -589,7 +604,7 @@ export function ChatProvider({
 
         addMessage(
           scopeId,
-          pendingChatSessionId,
+          effectiveSessionId,
           MessageRole.ASSISTANT,
           errorMessage,
         );
@@ -600,6 +615,7 @@ export function ChatProvider({
     },
     [
       addMessage,
+      removeMessageById,
       beginOutboundPending,
       endOutboundPending,
       getCurrentChatId,

package/src/contexts/chatPersistence.test.ts

@@ -0,0 +1,142 @@
+import { MessageRole } from '#uilib/components/ui/Chat/Chat.types';
+import type { Chat } from '#uilib/components/ui/Chat/Chat.types';
+
+import {
+  persistChatsToLS,
+  stripChatsForPersistence,
+  stripMessageForPersistence,
+} from './chatPersistence';
+
+describe('stripMessageForPersistence', () => {
+  it('removes json-dashboard fences from message text', () => {
+    const message = stripMessageForPersistence({
+      id: '1',
+      role: MessageRole.ASSISTANT,
+      text: 'Summary\n```json-dashboard\n{"tiles":[]}\n```',
+      timestamp: 1,
+    });
+
+    expect(message.text).toBe('Summary');
+  });
+
+  it('drops attachment content but keeps file metadata', () => {
+    const message = stripMessageForPersistence({
+      id: '2',
+      role: MessageRole.USER,
+      text: 'see file',
+      timestamp: 2,
+      userTextFileAttachments: [
+        {
+          displayName: 'Report',
+          filename: 'report.pdf',
+          content: 'x'.repeat(5000),
+        },
+      ],
+    });
+
+    expect(message.userTextFileAttachments).toEqual([
+      { displayName: 'Report', filename: 'report.pdf', content: '' },
+    ]);
+  });
+});
+
+describe('stripChatsForPersistence', () => {
+  it('filters in-progress messages', () => {
+    const chats: Chat[] = [
+      {
+        session_id: 's1',
+        name: '',
+        messages: [
+          {
+            id: 'a',
+            role: MessageRole.SYSTEM,
+            text: 'Working...',
+            timestamp: 1,
+            inProgress: true,
+          },
+          {
+            id: 'b',
+            role: MessageRole.USER,
+            text: 'hello',
+            timestamp: 2,
+          },
+        ],
+      },
+    ];
+
+    expect(stripChatsForPersistence(chats)[0].messages).toHaveLength(1);
+    expect(stripChatsForPersistence(chats)[0].messages[0].id).toBe('b');
+  });
+});
+
+describe('persistChatsToLS', () => {
+  const quotaError = new DOMException('quota', 'QuotaExceededError');
+
+  beforeEach(() => {
+    window.localStorage.clear();
+  });
+
+  it('swallows QuotaExceededError without throwing', () => {
+    const setItem = jest
+      .spyOn(Storage.prototype, 'setItem')
+      .mockImplementation(() => {
+        throw quotaError;
+      });
+
+    expect(() =>
+      persistChatsToLS('94-__reports_new_draft__', [
+        {
+          session_id: 's1',
+          name: '',
+          messages: [
+            {
+              id: '1',
+              role: MessageRole.USER,
+              text: 'hello',
+              timestamp: 1,
+            },
+          ],
+        },
+      ]),
+    ).not.toThrow();
+
+    setItem.mockRestore();
+  });
+
+  it('persists only the latest session for ephemeral draft scopes', () => {
+    persistChatsToLS('94-__reports_new_draft__', [
+      {
+        session_id: 'current',
+        name: '',
+        messages: [
+          {
+            id: '1',
+            role: MessageRole.USER,
+            text: 'current',
+            timestamp: 1,
+          },
+        ],
+      },
+      {
+        session_id: 'old',
+        name: '',
+        messages: [
+          {
+            id: '2',
+            role: MessageRole.USER,
+            text: 'old',
+            timestamp: 2,
+          },
+        ],
+      },
+    ]);
+
+    const stored = window.localStorage.getItem(
+      'chats-94-__reports_new_draft__',
+    );
+    expect(stored).not.toBeNull();
+    const parsed = JSON.parse(stored ?? '[]');
+    expect(parsed).toHaveLength(1);
+    expect(parsed[0].session_id).toBe('current');
+  });
+});

package/src/contexts/chatPersistence.ts

@@ -0,0 +1,79 @@
+import type {
+  Chat,
+  Message,
+  UserTextFileAttachment,
+} from '#uilib/components/ui/Chat/Chat.types';
+import { stripJsonDashboardFences } from '#uilib/lib/dashboard-spec/stripJsonDashboardFences';
+import { LS } from '@homecode/ui';
+
+/** Ephemeral scopes (e.g. /reports/new draft) — keep only the latest session in LS. */
+const EPHEMERAL_SCOPE_MARKERS = ['__reports_new_draft__'] as const;
+
+function isEphemeralChatScope(scopeId: string): boolean {
+  return EPHEMERAL_SCOPE_MARKERS.some(marker => scopeId.endsWith(marker));
+}
+
+function isQuotaExceededError(error: unknown): boolean {
+  if (!(error instanceof DOMException)) return false;
+  return (
+    error.name === 'QuotaExceededError' ||
+    error.code === 22 ||
+    error.code === 1014
+  );
+}
+
+function stripAttachmentForPersistence(
+  attachment: UserTextFileAttachment,
+): UserTextFileAttachment {
+  return {
+    displayName: attachment.displayName,
+    filename: attachment.filename,
+    content: '',
+  };
+}
+
+export function stripMessageForPersistence(message: Message): Message {
+  const text = stripJsonDashboardFences(message.text);
+  const next: Message = { ...message, text };
+  if (message.inProgress) {
+    delete next.inProgress;
+  }
+  if (message.userTextFileAttachments?.length) {
+    next.userTextFileAttachments = message.userTextFileAttachments.map(
+      stripAttachmentForPersistence,
+    );
+  }
+  return next;
+}
+
+export function stripChatsForPersistence(chats: Chat[]): Chat[] {
+  return chats.map(chat => ({
+    ...chat,
+    messages: chat.messages
+      .filter(message => !message.inProgress)
+      .map(stripMessageForPersistence),
+  }));
+}
+
+function chatsForScopePersistence(scopeId: string, chats: Chat[]): Chat[] {
+  const scopeChats = isEphemeralChatScope(scopeId) ? chats.slice(0, 1) : chats;
+  return stripChatsForPersistence(scopeChats);
+}
+
+export function persistChatsToLS(scopeId: string, chats: Chat[]): void {
+  const chatsKey = `chats-${scopeId}`;
+  const payload = chatsForScopePersistence(scopeId, chats);
+  try {
+    LS.set(chatsKey, payload);
+  } catch (error) {
+    if (!isQuotaExceededError(error)) throw error;
+  }
+}
+
+export function safeLsSet(key: string, value: unknown): void {
+  try {
+    LS.set(key, value);
+  } catch (error) {
+    if (!isQuotaExceededError(error)) throw error;
+  }
+}