@sybilion/uilib 1.3.40 → 1.3.43

package/README.md

@@ -108,15 +108,7 @@ Runtime dependencies are listed in `[package.json](./package.json)`.
 yarn publish:npm    # @sybilion/uilib
 ```
 
-runs `yarn build` before `npm publish`.
-
-**GitHub `github:` consumers:** after changing library **source**, regenerate and commit the prebuilt output:
-
-```bash
-yarn build
-```
-
-Then commit the updated `dist/` tree so GitHub installs stay up to date.
+runs `yarn build` before `npm publish`. `dist/` is build output only (not committed); consumers install prebuilt artifacts from the npm registry.
 
 ## Integration notes (injected props)
 
@@ -131,7 +123,6 @@ These areas expect the **app** to supply behavior or data (not vendored from pro
 
 ## Scripts (this repo)
 
-
 | Script                | Description                                 |
 | --------------------- | ------------------------------------------- |
 | `yarn dev`            | Webpack dev server for the docs app         |
@@ -143,5 +134,3 @@ These areas expect the **app** to supply behavior or data (not vendored from pro
 | `yarn ts`             | Typecheck (`tsc --noEmit`)                  |
 | `yarn tests`          | Jest smoke tests                            |
 | `yarn release`        | `standard-version` (bump changelog + tag)   |
-
-

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

@@ -20,9 +20,9 @@ function ChatChrome({ showResizeHandle, resizeHandle, onClose, isEmpty, renderPr
     const attachmentAccept = useMemo(() => buildAcceptAttr(filteredAllowedAttachments, allowPdfAttachments), [filteredAllowedAttachments, allowPdfAttachments]);
     const [pendingAttachments, setPendingAttachments] = useState([]);
     const [isExtractingAttachments, setIsExtractingAttachments] = useState(false);
-    const promptBusy = isLoading || isExtractingAttachments;
+    const promptDisabled = isExtractingAttachments;
     const handleAttachmentFiles = useCallback((files) => {
-        if (promptBusy || files.length === 0)
+        if (promptDisabled || files.length === 0)
             return;
         setIsExtractingAttachments(true);
         void extractChatAttachmentItems(files, allowPdfAttachments)
@@ -35,7 +35,7 @@ function ChatChrome({ showResizeHandle, resizeHandle, onClose, isEmpty, renderPr
             // Extraction failed (parse error, size limit, etc.); skip staging.
         })
             .finally(() => setIsExtractingAttachments(false));
-    }, [allowPdfAttachments, promptBusy]);
+    }, [allowPdfAttachments, promptDisabled]);
     const handleRemoveAttachment = useCallback((index) => {
         setPendingAttachments(prev => prev.filter((_, i) => i !== index));
     }, []);
@@ -66,7 +66,7 @@ function ChatChrome({ showResizeHandle, resizeHandle, onClose, isEmpty, renderPr
         if (inner)
             setTimeout(scrollToBottom, 100);
     }, [isEmpty, messages.length]);
-    return (jsxs("div", { className: S.root, children: [showResizeHandle && resizeHandle ? (jsx(PanelResizeHandle, { edge: "leading", isActive: resizeHandle.isActive, startWidthPx: resizeHandle.startWidthPx, getShellWidth: resizeHandle.getShellWidth, onDragWidth: resizeHandle.onDragWidth, onDragComplete: resizeHandle.onDragComplete, className: cn(SidebarStem.sidebarResizeHandle, S.chatResizeHandle) })) : null, jsx("div", { className: S.panelHeader, children: onClose ? (jsx(Button, { type: "button", variant: "ghost", icon: true, className: S.panelClose, "aria-label": "Close chat", onClick: onClose, children: jsx(X, { className: "size-4" }) })) : null }), jsxs("div", { className: S.content, children: [attachmentsDropzoneEnabled ? (jsx(DropZone, { accept: attachmentAccept, label: "Drop text files to attach", multiple: true, ghost: true, overlayScope: "container", disabled: promptBusy, className: S.attachmentDropzone, onFiles: handleAttachmentFiles })) : null, jsxs(Chat, { isEmpty: isEmpty, scopeId: effectiveScopeId, onChatDeleted: onChatDeleted, children: [isEmpty ? (jsxs(Fragment, { children: [jsx(Chat.EmptyState, { ...emptyState }), renderPresets('fixed')] })) : (jsx("div", { className: S.scrollWrapper, children: jsxs(Scroll, { y: true, yScrollbarClassName: S.scrollbar, className: S.scroll, innerClassName: S.scrollInner, offset: { y: { before: 56, after: 180 } }, fadeSize: "m", autoHide: true, ref: scrollRef, children: [messages.map((msg, index, arr) => {
+    return (jsxs("div", { className: S.root, children: [showResizeHandle && resizeHandle ? (jsx(PanelResizeHandle, { edge: "leading", isActive: resizeHandle.isActive, startWidthPx: resizeHandle.startWidthPx, getShellWidth: resizeHandle.getShellWidth, onDragWidth: resizeHandle.onDragWidth, onDragComplete: resizeHandle.onDragComplete, className: cn(SidebarStem.sidebarResizeHandle, S.chatResizeHandle) })) : null, jsx("div", { className: S.panelHeader, children: onClose ? (jsx(Button, { type: "button", variant: "ghost", icon: true, className: S.panelClose, "aria-label": "Close chat", onClick: onClose, children: jsx(X, { className: "size-4" }) })) : null }), jsxs("div", { className: S.content, children: [attachmentsDropzoneEnabled ? (jsx(DropZone, { accept: attachmentAccept, label: "Drop text files to attach", multiple: true, ghost: true, overlayScope: "container", disabled: promptDisabled, className: S.attachmentDropzone, onFiles: handleAttachmentFiles })) : null, jsxs(Chat, { isEmpty: isEmpty, scopeId: effectiveScopeId, onChatDeleted: onChatDeleted, children: [isEmpty ? (jsxs(Fragment, { children: [jsx(Chat.EmptyState, { ...emptyState }), renderPresets('fixed')] })) : (jsx("div", { className: S.scrollWrapper, children: jsxs(Scroll, { y: true, yScrollbarClassName: S.scrollbar, className: S.scroll, innerClassName: S.scrollInner, offset: { y: { before: 56, after: 180 } }, fadeSize: "m", autoHide: true, ref: scrollRef, children: [messages.map((msg, index, arr) => {
                                             const isLast = index === arr.length - 1;
                                             return (jsx(Chat.Message, { role: msg.role, text: msg.text, inProgress: msg.inProgress, userTextFileAttachments: msg.userTextFileAttachments, onQuickReply: onQuickReply, suppressedQuickReplyKeys: suppressedQuickReplyKeys, quickReplyDisabled: isLoading, isLastMessage: isLast, scriptContinue: isLast && scriptContinueLabel
                                                     ? { label: scriptContinueLabel }
@@ -77,7 +77,7 @@ 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 && (jsx(TextShimmer, { duration: 1, spread: 5, className: S.loader, children: "Thinking..." }))] }) })), 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: promptBusy, 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 && isLastMessageFromUser && (jsx(TextShimmer, { duration: 1, spread: 5, className: S.loader, children: "Thinking..." }))] }) })), 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/ChatMessage/ChatMessage.styl.js

@@ -1,7 +1,7 @@
 import styleInject from 'style-inject';
 
-var css_248z = ".ChatMessage_root__6rnsF{background:var(--bg-secondary);display:flex;flex-direction:column;gap:var(--p-1);padding:var(--p-6)}.ChatMessage_text__Y1XNR{color:var(--text-secondary);font-size:var(--text-sm);max-width:100%;min-width:0;overflow-wrap:anywhere;-webkit-user-select:text;-moz-user-select:text;user-select:text;width:-moz-fit-content;width:fit-content;word-break:break-word}.ChatMessage_role-user__u4JPV{align-items:flex-end;max-width:100%;min-width:0}.ChatMessage_role-user__u4JPV .ChatMessage_userColumn__cQM6-{align-items:flex-end;display:flex;flex-direction:column;gap:var(--p-2);max-width:100%;min-width:0}.ChatMessage_role-user__u4JPV .ChatMessage_text__Y1XNR{background-color:var(--sb-slate-100);border-radius:var(--p-4);border-bottom-right-radius:0;box-sizing:border-box;overflow:hidden;padding:var(--p-3) var(--p-4);white-space:pre-wrap}.dark .ChatMessage_role-user__u4JPV .ChatMessage_text__Y1XNR{background-color:var(--sb-gray-800)}.ChatMessage_role-system__g13OP{align-items:center}.ChatMessage_role-system__g13OP .ChatMessage_text__Y1XNR{color:var(--muted-foreground);font-size:var(--text-xs);width:100%}.ChatMessage_role-assistant__wketE .ChatMessage_text__Y1XNR{width:100%}.ChatMessage_role-assistant__wketE h3{line-height:2.4}.ChatMessage_role-assistant__wketE h4{font-size:1.1em;font-weight:600;line-height:2.2}.ChatMessage_role-assistant__wketE .ChatMessage_bullet__6vAhq{display:inline-block;margin-left:4px;margin-right:6px}.ChatMessage_role-assistant__wketE .ChatMessage_bullet__6vAhq:before{color:var(--text-secondary);content:\"•\";display:inline-block}.ChatMessage_role-assistant__wketE .ChatMessage_scrollHorizontal__Rms9n{max-width:100%}.ChatMessage_role-assistant__wketE table{border:1px solid var(--border);border-collapse:collapse;border-radius:var(--p-2);border-spacing:0;margin:var(--p-4) 0;overflow:hidden}.ChatMessage_role-assistant__wketE table td,.ChatMessage_role-assistant__wketE table th{border:1px solid var(--border);min-width:100px;padding:var(--p-1)}.ChatMessage_role-assistant__wketE table th{text-align:left}.ChatMessage_role-assistant__wketE ol,.ChatMessage_role-assistant__wketE ul{padding-left:var(--p-4)}.ChatMessage_role-assistant__wketE ul{list-style-type:disc}.ChatMessage_role-assistant__wketE ol{list-style-type:decimal}.ChatMessage_role-assistant__wketE .ChatMessage_datasetAppLink__Pxy-T{align-items:center;border:1px dashed var(--sb-slate-300);border-radius:8px;color:var(--foreground);display:inline-flex;font-size:var(--text-xs);gap:6px;margin:1px;max-width:100%;padding:2px 6px 2px 4px;text-decoration:none;vertical-align:middle}.ChatMessage_role-assistant__wketE .ChatMessage_datasetAppLink__Pxy-T:hover{background-color:var(--sb-slate-50);border-color:var(--sb-slate-400);border-style:solid}.dark .ChatMessage_role-assistant__wketE .ChatMessage_datasetAppLink__Pxy-T{border-color:var(--sb-gray-600)}.dark .ChatMessage_role-assistant__wketE .ChatMessage_datasetAppLink__Pxy-T:hover{background-color:var(--sb-gray-900)}.ChatMessage_role-assistant__wketE .ChatMessage_datasetAppLinkLabel__PMU7e{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.ChatMessage_role-assistant__wketE .ChatMessage_quickReplyWrap__1UFyD{display:inline-block;margin:var(--p-1) var(--p-1) var(--p-1) 0;vertical-align:middle}.ChatMessage_role-assistant__wketE .ChatMessage_downloadButtons__RygM-{display:flex;gap:var(--p-2);margin-top:var(--p-4)}.ChatMessage_role-assistant__wketE .ChatMessage_downloadCard__NsNRa{align-items:center;background-color:var(--background);border-radius:var(--p-3);box-shadow:0 0 0 1px var(--border);cursor:pointer;display:flex;gap:var(--p-4);margin-top:var(--p-3);padding:var(--p-3);padding-right:var(--p-4);transition:all .15s;width:-moz-fit-content;width:fit-content}.ChatMessage_role-assistant__wketE .ChatMessage_downloadCard__NsNRa:hover{background-color:var(--sb-gray-50);border-color:var(--border)}.dark .ChatMessage_role-assistant__wketE .ChatMessage_downloadCard__NsNRa{background-color:var(--sb-gray-900);border-color:var(--border)}.dark .ChatMessage_role-assistant__wketE .ChatMessage_downloadCard__NsNRa:hover{background-color:var(--sb-gray-800)}.ChatMessage_role-assistant__wketE .ChatMessage_downloadCardIcon__jkxDJ{align-items:center;border-radius:var(--p-2);display:flex;flex-shrink:0;height:32px;justify-content:center;width:32px}.ChatMessage_role-assistant__wketE .ChatMessage_downloadCardContent__PTPwz{display:flex;flex:1;flex-direction:column;min-width:0}.ChatMessage_role-assistant__wketE .ChatMessage_downloadCardTitle__K1wqr{font-size:var(--text-base);font-weight:600;line-height:1.4}.ChatMessage_role-assistant__wketE .ChatMessage_downloadCardSubtitle__fVeF2{color:var(--muted-foreground);font-size:var(--text-sm);line-height:1.4}";
-var S = {"root":"ChatMessage_root__6rnsF","text":"ChatMessage_text__Y1XNR","role-user":"ChatMessage_role-user__u4JPV","userColumn":"ChatMessage_userColumn__cQM6-","role-system":"ChatMessage_role-system__g13OP","role-assistant":"ChatMessage_role-assistant__wketE","bullet":"ChatMessage_bullet__6vAhq","scrollHorizontal":"ChatMessage_scrollHorizontal__Rms9n","datasetAppLink":"ChatMessage_datasetAppLink__Pxy-T","datasetAppLinkLabel":"ChatMessage_datasetAppLinkLabel__PMU7e","quickReplyWrap":"ChatMessage_quickReplyWrap__1UFyD","downloadButtons":"ChatMessage_downloadButtons__RygM-","downloadCard":"ChatMessage_downloadCard__NsNRa","downloadCardIcon":"ChatMessage_downloadCardIcon__jkxDJ","downloadCardContent":"ChatMessage_downloadCardContent__PTPwz","downloadCardTitle":"ChatMessage_downloadCardTitle__K1wqr","downloadCardSubtitle":"ChatMessage_downloadCardSubtitle__fVeF2"};
+var css_248z = ".ChatMessage_root__6rnsF{background:var(--bg-secondary);display:flex;flex-direction:column;gap:var(--p-1);padding:var(--p-4);padding-bottom:var(--p-1)}.ChatMessage_text__Y1XNR{color:var(--text-secondary);font-size:var(--text-sm);max-width:100%;min-width:0;overflow-wrap:anywhere;-webkit-user-select:text;-moz-user-select:text;user-select:text;width:-moz-fit-content;width:fit-content;word-break:break-word}.ChatMessage_role-assistant__wketE+.ChatMessage_role-assistant__wketE,.ChatMessage_role-system__g13OP+.ChatMessage_role-system__g13OP,.ChatMessage_role-user__u4JPV+.ChatMessage_role-user__u4JPV{padding-top:var(--p-1)}.ChatMessage_role-user__u4JPV{align-items:flex-end;max-width:100%;min-width:0}.ChatMessage_role-user__u4JPV .ChatMessage_userColumn__cQM6-{align-items:flex-end;display:flex;flex-direction:column;gap:var(--p-2);max-width:100%;min-width:0}.ChatMessage_role-user__u4JPV .ChatMessage_text__Y1XNR{background-color:var(--sb-slate-100);border-radius:var(--p-4);border-bottom-right-radius:0;box-sizing:border-box;overflow:hidden;padding:var(--p-3) var(--p-4);white-space:pre-wrap}.dark .ChatMessage_role-user__u4JPV .ChatMessage_text__Y1XNR{background-color:var(--sb-gray-800)}.ChatMessage_role-system__g13OP{align-items:center}.ChatMessage_role-system__g13OP .ChatMessage_text__Y1XNR{color:var(--muted-foreground);width:100%}.ChatMessage_role-assistant__wketE .ChatMessage_text__Y1XNR{width:100%}.ChatMessage_role-assistant__wketE h3{line-height:2.4}.ChatMessage_role-assistant__wketE h4{font-size:1.1em;font-weight:600;line-height:2.2}.ChatMessage_role-assistant__wketE .ChatMessage_bullet__6vAhq{display:inline-block;margin-left:4px;margin-right:6px}.ChatMessage_role-assistant__wketE .ChatMessage_bullet__6vAhq:before{color:var(--text-secondary);content:\"•\";display:inline-block}.ChatMessage_role-assistant__wketE .ChatMessage_scrollHorizontal__Rms9n{max-width:100%}.ChatMessage_role-assistant__wketE table{border:1px solid var(--border);border-collapse:collapse;border-radius:var(--p-2);border-spacing:0;margin:var(--p-4) 0;overflow:hidden}.ChatMessage_role-assistant__wketE table td,.ChatMessage_role-assistant__wketE table th{border:1px solid var(--border);min-width:100px;padding:var(--p-1)}.ChatMessage_role-assistant__wketE table th{text-align:left}.ChatMessage_role-assistant__wketE ol,.ChatMessage_role-assistant__wketE ul{padding-left:var(--p-4)}.ChatMessage_role-assistant__wketE ul{list-style-type:disc}.ChatMessage_role-assistant__wketE ol{list-style-type:decimal}.ChatMessage_role-assistant__wketE .ChatMessage_datasetAppLink__Pxy-T{align-items:center;border:1px dashed var(--sb-slate-300);border-radius:8px;color:var(--foreground);display:inline-flex;font-size:var(--text-xs);gap:6px;margin:1px;max-width:100%;padding:2px 6px 2px 4px;text-decoration:none;vertical-align:middle}.ChatMessage_role-assistant__wketE .ChatMessage_datasetAppLink__Pxy-T:hover{background-color:var(--sb-slate-50);border-color:var(--sb-slate-400);border-style:solid}.dark .ChatMessage_role-assistant__wketE .ChatMessage_datasetAppLink__Pxy-T{border-color:var(--sb-gray-600)}.dark .ChatMessage_role-assistant__wketE .ChatMessage_datasetAppLink__Pxy-T:hover{background-color:var(--sb-gray-900)}.ChatMessage_role-assistant__wketE .ChatMessage_datasetAppLinkLabel__PMU7e{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.ChatMessage_role-assistant__wketE .ChatMessage_quickReplyWrap__1UFyD{display:inline-block;margin:var(--p-1) var(--p-1) var(--p-1) 0;vertical-align:middle}.ChatMessage_role-assistant__wketE .ChatMessage_downloadButtons__RygM-{display:flex;gap:var(--p-2);margin-top:var(--p-4)}.ChatMessage_role-assistant__wketE .ChatMessage_downloadCard__NsNRa{align-items:center;background-color:var(--background);border-radius:var(--p-3);box-shadow:0 0 0 1px var(--border);cursor:pointer;display:flex;gap:var(--p-4);margin-top:var(--p-3);padding:var(--p-3);padding-right:var(--p-4);transition:all .15s;width:-moz-fit-content;width:fit-content}.ChatMessage_role-assistant__wketE .ChatMessage_downloadCard__NsNRa:hover{background-color:var(--sb-gray-50);border-color:var(--border)}.dark .ChatMessage_role-assistant__wketE .ChatMessage_downloadCard__NsNRa{background-color:var(--sb-gray-900);border-color:var(--border)}.dark .ChatMessage_role-assistant__wketE .ChatMessage_downloadCard__NsNRa:hover{background-color:var(--sb-gray-800)}.ChatMessage_role-assistant__wketE .ChatMessage_downloadCardIcon__jkxDJ{align-items:center;border-radius:var(--p-2);display:flex;flex-shrink:0;height:32px;justify-content:center;width:32px}.ChatMessage_role-assistant__wketE .ChatMessage_downloadCardContent__PTPwz{display:flex;flex:1;flex-direction:column;min-width:0}.ChatMessage_role-assistant__wketE .ChatMessage_downloadCardTitle__K1wqr{font-size:var(--text-base);font-weight:600;line-height:1.4}.ChatMessage_role-assistant__wketE .ChatMessage_downloadCardSubtitle__fVeF2{color:var(--muted-foreground);font-size:var(--text-sm);line-height:1.4}";
+var S = {"root":"ChatMessage_root__6rnsF","text":"ChatMessage_text__Y1XNR","role-user":"ChatMessage_role-user__u4JPV","role-assistant":"ChatMessage_role-assistant__wketE","role-system":"ChatMessage_role-system__g13OP","userColumn":"ChatMessage_userColumn__cQM6-","bullet":"ChatMessage_bullet__6vAhq","scrollHorizontal":"ChatMessage_scrollHorizontal__Rms9n","datasetAppLink":"ChatMessage_datasetAppLink__Pxy-T","datasetAppLinkLabel":"ChatMessage_datasetAppLinkLabel__PMU7e","quickReplyWrap":"ChatMessage_quickReplyWrap__1UFyD","downloadButtons":"ChatMessage_downloadButtons__RygM-","downloadCard":"ChatMessage_downloadCard__NsNRa","downloadCardIcon":"ChatMessage_downloadCardIcon__jkxDJ","downloadCardContent":"ChatMessage_downloadCardContent__PTPwz","downloadCardTitle":"ChatMessage_downloadCardTitle__K1wqr","downloadCardSubtitle":"ChatMessage_downloadCardSubtitle__fVeF2"};
 styleInject(css_248z);
 
 export { S as default };

package/dist/esm/components/ui/Chat/ChatPrompt/ChatPromptComposer.js

@@ -19,7 +19,7 @@ function ChatPromptComposer({ editor, disabled, trimmedMessage, attachments, att
     return (jsxs("div", { className: S.composer, children: [showAttachButton ? (jsxs(Fragment, { children: [jsx("input", { ref: fileInputRef, type: "file", accept: attachmentAccept, multiple: true, className: S.fileInput, disabled: disabled, onChange: handleFileInputChange }), jsx(Button, { type: "button", variant: "ghost", icon: true, size: "sm", className: S.attachButton, "aria-label": "Attach file", disabled: disabled, onClick: e => {
                             e.preventDefault();
                             fileInputRef.current?.click();
-                        }, children: jsx(PaperclipIcon, { size: 16 }) })] })) : null, jsx("div", { className: S.editorWrap, onKeyDown: onComposerKeyDown, children: jsx(EditorContent, { editor: editor, className: S.editorMount }) }), jsx("div", { className: S.submitColumn, children: jsx(Button, { type: "submit", size: "sm", disabled: disabled || !canSubmit, children: jsx(SendHorizontalIcon, { size: 16 }) }) })] }));
+                        }, children: jsx(PaperclipIcon, { size: 16 }) })] })) : null, jsx("div", { className: S.editorWrap, onKeyDown: onComposerKeyDown, children: jsx(EditorContent, { editor: editor, className: S.editorMount }) }), jsx("div", { className: S.submitColumn, children: jsx(Button, { type: "submit", size: "sm", disabled: disabled || !canSubmit, onMouseDown: e => e.preventDefault(), children: jsx(SendHorizontalIcon, { size: 16 }) }) })] }));
 }
 
 export { ChatPromptComposer };

package/dist/esm/components/ui/Chat/ChatPrompt/useChatPromptEditor.js

@@ -136,7 +136,7 @@ function useChatPromptEditor({ disabled, placeholder, slashCommandItems, onSlash
     const resetAfterSend = useCallback(() => {
         if (!editor)
             return;
-        editor.commands.clearContent();
+        editor.chain().clearContent().focus().run();
         queueMicrotask(() => {
             const dom = chatPromptSafeEditorDom(editor);
             if (dom)

package/dist/esm/components/ui/RegionCoords/RegionSelector.js

@@ -6,7 +6,7 @@ import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuIte
 import { CaretDownIcon } from '@phosphor-icons/react';
 import S from './RegionSelector.styl.js';
 
-function RegionSelector({ children, onSelect, className, regions: regionCoordinates, }) {
+function RegionSelector({ children, onSelect, className, regions: regionCoordinates = {}, }) {
     const [open, setOpen] = useState(false);
     const handleRegionSelect = (regionName) => {
         const coords = regionCoordinates[regionName];
@@ -16,7 +16,7 @@ function RegionSelector({ children, onSelect, className, regions: regionCoordina
         }
     };
     const regions = Object.keys(regionCoordinates).sort();
-    return (jsxs("div", { className: cn(S.root, className), children: [children, jsxs(DropdownMenu, { open: open, onOpenChange: setOpen, children: [jsx(DropdownMenuTrigger, { asChild: true, children: jsx(Button, { variant: "outline", size: "sm", className: S.button, children: jsx(CaretDownIcon, { size: 16 }) }) }), jsx(DropdownMenuContent, { align: "end", children: regions.map(region => (jsx(DropdownMenuItem, { onSelect: () => handleRegionSelect(region), children: region }, region))) })] })] }));
+    return (jsxs("div", { className: cn(S.root, className), children: [children, regions.length > 0 && (jsxs(DropdownMenu, { open: open, onOpenChange: setOpen, children: [jsx(DropdownMenuTrigger, { asChild: true, children: jsx(Button, { variant: "outline", size: "sm", className: S.button, children: jsx(CaretDownIcon, { size: 16 }) }) }), jsx(DropdownMenuContent, { align: "end", children: regions.map(region => (jsx(DropdownMenuItem, { onSelect: () => handleRegionSelect(region), children: region }, region))) })] }))] }));
 }
 
 export { RegionSelector };

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

@@ -234,6 +234,42 @@ function ChatProvider({ children, userSwitchKey, sendChatMessage: sendChatMessag
             return { ...prev, [scopeId]: updatedChats };
         });
     }, [userSwitchKey]);
+    const updateMessageById = useCallback((scopeId, chatId, messageId, patch) => {
+        if (userSwitchKey === null)
+            return;
+        setChats(prev => {
+            const scopeChats = prev[scopeId] ?? [];
+            const updatedChats = scopeChats.map(chat => {
+                if (chat.session_id !== chatId)
+                    return chat;
+                return {
+                    ...chat,
+                    messages: chat.messages.map(message => {
+                        if (message.id !== messageId)
+                            return message;
+                        const next = { ...message };
+                        if (patch.role != null) {
+                            next.role = patch.role;
+                        }
+                        if (patch.text != null) {
+                            next.text = stripJsonDashboardFences(patch.text);
+                        }
+                        if (patch.inProgress === true) {
+                            next.inProgress = true;
+                        }
+                        else if (patch.inProgress === false ||
+                            (patch.role != null && patch.role !== MessageRole.SYSTEM)) {
+                            delete next.inProgress;
+                        }
+                        return next;
+                    }),
+                };
+            });
+            const chatsKey = getChatsKey(scopeId);
+            LS.set(chatsKey, updatedChats);
+            return { ...prev, [scopeId]: updatedChats };
+        });
+    }, [userSwitchKey]);
     const sendMessage = useCallback(async (scopeId, message, chatId) => {
         const targetChatId = chatId ?? getCurrentChatId(scopeId);
         if (targetChatId === null || targetChatId === '') {
@@ -310,6 +346,7 @@ function ChatProvider({ children, userSwitchKey, sendChatMessage: sendChatMessag
             setCurrentChatId,
             addMessage,
             removeMessageById,
+            updateMessageById,
             sendMessage,
             getChatsForScopeId,
             getCurrentChatId,
@@ -370,7 +407,7 @@ function useSyncChatPanelBusy(isLoading) {
     }, [isLoading, acquirePanelBusy, releasePanelBusy]);
 }
 function useChatsForScopeId(scopeId) {
-    const { getChatsForScopeId, getCurrentChatId, setCurrentChatId, newChat, addMessage, removeMessageById, sendMessage, deleteChat, } = useChats();
+    const { getChatsForScopeId, getCurrentChatId, setCurrentChatId, newChat, addMessage, removeMessageById, updateMessageById, sendMessage, deleteChat, } = useChats();
     const chats = getChatsForScopeId(scopeId);
     const currentChatId = getCurrentChatId(scopeId);
     const currentChat = useChat(scopeId, currentChatId ?? undefined);
@@ -384,6 +421,7 @@ function useChatsForScopeId(scopeId) {
         newChat: () => newChat(scopeId),
         addMessage: (chatId, role, text, options) => addMessage(scopeId, chatId, role, text, options),
         removeMessageById: (chatId, messageId) => removeMessageById(scopeId, chatId, messageId),
+        updateMessageById: (chatId, messageId, patch) => updateMessageById(scopeId, chatId, messageId, patch),
         sendMessage: (message, chatId) => sendMessage(scopeId, message, chatId),
         deleteChat: (sessionId) => deleteChat(scopeId, sessionId),
     };

package/dist/esm/types/src/components/ui/RegionCoords/RegionSelector.types.d.ts

@@ -6,7 +6,7 @@ export interface RegionSelectorProps {
     }) => void;
     className?: string;
     /** Region name → coordinates (app-defined; replaces app-only drivers catalog). */
-    regions: Record<string, {
+    regions?: Record<string, {
         longitude: number;
         latitude: number;
     }>;

package/dist/esm/types/src/contexts/chat-context.d.ts

@@ -8,12 +8,18 @@ export type AddChatMessageOptions = {
     /** SYSTEM-only: mark as transient progress placeholder (shimmer until removed). */
     inProgress?: boolean;
 };
+export type UpdateChatMessagePatch = {
+    role?: MessageRole;
+    text?: string;
+    inProgress?: boolean;
+};
 export interface ChatContextType {
     /** Returns the new session id, or undefined if no user / not created. */
     newChat: (scopeId: string) => string | undefined;
     setCurrentChatId: (currScopeId: string, sessionId: string) => void;
     addMessage: (scopeId: string, chatId: string, role: MessageRole, text: string, options?: AddChatMessageOptions) => string | undefined;
     removeMessageById: (scopeId: string, chatId: string, messageId: string) => void;
+    updateMessageById: (scopeId: string, chatId: string, messageId: string, patch: UpdateChatMessagePatch) => void;
     sendMessage: (scopeId: string, message: string | ChatSendMessagePayload, chatId?: string) => Promise<string>;
     getChatsForScopeId: (scopeId: string) => Chat[];
     getCurrentChatId: (scopeId: string) => string | null;
@@ -55,6 +61,7 @@ export declare function useChatsForScopeId(scopeId: string): {
     newChat: () => string;
     addMessage: (chatId: string, role: MessageRole, text: string, options?: AddChatMessageOptions) => string;
     removeMessageById: (chatId: string, messageId: string) => void;
+    updateMessageById: (chatId: string, messageId: string, patch: UpdateChatMessagePatch) => void;
     sendMessage: (message: string | ChatSendMessagePayload, chatId?: string) => Promise<string>;
     deleteChat: (sessionId: string) => void;
 };
@@ -68,6 +75,7 @@ export declare function useChatsForDataset(scopeId: string): {
     newChat: () => string;
     addMessage: (chatId: string, role: MessageRole, text: string, options?: AddChatMessageOptions) => string;
     removeMessageById: (chatId: string, messageId: string) => void;
+    updateMessageById: (chatId: string, messageId: string, patch: UpdateChatMessagePatch) => void;
     sendMessage: (message: string | ChatSendMessagePayload, chatId?: string) => Promise<string>;
     deleteChat: (sessionId: string) => void;
 };

package/package.json

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

package/src/components/ui/ChartAreaInteractive/AGENT.md

@@ -0,0 +1,19 @@
+# ChartAreaInteractive
+
+Renders: time-series chart with historical line, forecast lines, optional pin / quantile-band / threshold overlays.
+
+Use when: custom forecast UI with overlays or full chart control.
+Not when: packaged performance or drivers-comparison views (use PerformanceChart or DriversComparisonChart).
+
+Host provides:
+
+- `chartData`, `forecastData` built from API
+- `timeRange` / `onTimeRangeChange` or brush-only range
+- Optional `mode`: pin | intervals | thresholds + overlay state
+- Analysis selector and fetch outside widget
+
+Report tile: `dataset_card` — host loads dataset + analysis; chart inside dashboard card.
+
+Requires: `chartData`; `forecastData`; `loading`; `toggleLegendSeries` / `ensureAnalysisSeriesVisible` when legend is external.
+
+Empty/loading: `loading`, `error`; empty data shows chart empty state via host message props.

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

@@ -71,11 +71,11 @@ export function ChatChrome({
     ChatAttachmentDropItem[]
   >([]);
   const [isExtractingAttachments, setIsExtractingAttachments] = useState(false);
-  const promptBusy = isLoading || isExtractingAttachments;
+  const promptDisabled = isExtractingAttachments;
 
   const handleAttachmentFiles = useCallback(
     (files: File[]) => {
-      if (promptBusy || files.length === 0) return;
+      if (promptDisabled || files.length === 0) return;
 
       setIsExtractingAttachments(true);
       void extractChatAttachmentItems(files, allowPdfAttachments)
@@ -89,7 +89,7 @@ export function ChatChrome({
         })
         .finally(() => setIsExtractingAttachments(false));
     },
-    [allowPdfAttachments, promptBusy],
+    [allowPdfAttachments, promptDisabled],
   );
 
   const handleRemoveAttachment = useCallback((index: number) => {
@@ -165,7 +165,7 @@ export function ChatChrome({
             multiple
             ghost
             overlayScope="container"
-            disabled={promptBusy}
+            disabled={promptDisabled}
             className={S.attachmentDropzone}
             onFiles={handleAttachmentFiles}
           />
@@ -263,7 +263,7 @@ export function ChatChrome({
             ) : null}
             <Chat.Prompt
               onSubmit={handlePromptSubmitWithAttachments}
-              disabled={promptBusy}
+              disabled={promptDisabled}
               attachments={pendingAttachments}
               onRemoveAttachment={handleRemoveAttachment}
               prefillMessage={promptPrefill ?? undefined}

package/src/components/ui/Chat/ChatMessage/ChatMessage.styl

@@ -3,7 +3,8 @@
   flex-direction column
   gap var(--p-1)
 
-  padding var(--p-6)
+  padding var(--p-4)
+  padding-bottom var(--p-1)
   background var(--bg-secondary)
 
 .text
@@ -16,6 +17,12 @@
   overflow-wrap anywhere
   word-break break-word
 
+.role-user
+.role-assistant
+.role-system
+  & + &
+    padding-top var(--p-1)
+
 .role-user
   align-items flex-end
   max-width 100%
@@ -48,7 +55,6 @@
 
   .text
     width 100%
-    font-size var(--text-xs)
     color var(--muted-foreground)
 
 .role-assistant

package/src/components/ui/Chat/ChatPrompt/ChatPromptComposer.tsx

@@ -84,7 +84,12 @@ export function ChatPromptComposer({
       </div>
 
       <div className={S.submitColumn}>
-        <Button type="submit" size="sm" disabled={disabled || !canSubmit}>
+        <Button
+          type="submit"
+          size="sm"
+          disabled={disabled || !canSubmit}
+          onMouseDown={e => e.preventDefault()}
+        >
           <SendHorizontalIcon size={16} />
         </Button>
       </div>

package/src/components/ui/Chat/ChatPrompt/useChatPromptEditor.ts

@@ -193,7 +193,7 @@ export function useChatPromptEditor({
 
   const resetAfterSend = useCallback(() => {
     if (!editor) return;
-    editor.commands.clearContent();
+    editor.chain().clearContent().focus().run();
     queueMicrotask(() => {
       const dom = chatPromptSafeEditorDom(editor);
       if (dom) syncChatPromptComposerHeight(dom, '');

package/src/components/ui/RegionCoords/RegionSelector.tsx

@@ -17,7 +17,7 @@ export function RegionSelector({
   children,
   onSelect,
   className,
-  regions: regionCoordinates,
+  regions: regionCoordinates = {},
 }: RegionSelectorProps) {
   const [open, setOpen] = useState(false);
 
@@ -34,23 +34,25 @@ export function RegionSelector({
   return (
     <div className={cn(S.root, className)}>
       {children}
-      <DropdownMenu open={open} onOpenChange={setOpen}>
-        <DropdownMenuTrigger asChild>
-          <Button variant="outline" size="sm" className={S.button}>
-            <CaretDownIcon size={16} />
-          </Button>
-        </DropdownMenuTrigger>
-        <DropdownMenuContent align="end">
-          {regions.map(region => (
-            <DropdownMenuItem
-              key={region}
-              onSelect={() => handleRegionSelect(region)}
-            >
-              {region}
-            </DropdownMenuItem>
-          ))}
-        </DropdownMenuContent>
-      </DropdownMenu>
+      {regions.length > 0 && (
+        <DropdownMenu open={open} onOpenChange={setOpen}>
+          <DropdownMenuTrigger asChild>
+            <Button variant="outline" size="sm" className={S.button}>
+              <CaretDownIcon size={16} />
+            </Button>
+          </DropdownMenuTrigger>
+          <DropdownMenuContent align="end">
+            {regions.map(region => (
+              <DropdownMenuItem
+                key={region}
+                onSelect={() => handleRegionSelect(region)}
+              >
+                {region}
+              </DropdownMenuItem>
+            ))}
+          </DropdownMenuContent>
+        </DropdownMenu>
+      )}
     </div>
   );
 }

package/src/components/ui/RegionCoords/RegionSelector.types.ts

@@ -6,5 +6,5 @@ export interface RegionSelectorProps {
   ) => void;
   className?: string;
   /** Region name → coordinates (app-defined; replaces app-only drivers catalog). */
-  regions: Record<string, { longitude: number; latitude: number }>;
+  regions?: Record<string, { longitude: number; latitude: number }>;
 }

package/src/components/widgets/AGENT.md

@@ -0,0 +1,21 @@
+<!-- not a component — authoring guide only -->
+
+# Widget `AGENT.md` authoring
+
+Each component file ≤18 lines. Signal for LLM prompts — no noise.
+
+**Include:** Renders (1 sentence); Use when / Not when; Host provides (3–5 bullets); Report tile (one line or "Not used"); Requires (prop names + role); Empty/loading (one line).
+
+**Do not include:** import examples; type/doc/demo/glossary links; page-shell boilerplate; related-components lists unless choosing between exports; implementation/styling/keyboard notes unless binding-relevant; secrets, env vars, API URLs.
+
+```markdown
+# Name
+
+Renders: …
+Use when: …
+Not when: …
+Host provides: …
+Report tile: …
+Requires: …
+Empty/loading: …
+```

package/src/components/widgets/DriverMap/AGENT.md

@@ -0,0 +1,18 @@
+# DriverMap
+
+Renders: world map with regional driver badges, bottom strip for world-level drivers, selection highlight.
+
+Use when: geographic driver exploration for one analysis.
+Not when: driver detail metrics card alone (pair with DriverCard) or normalized series chart (use DriversComparisonChart).
+
+Host provides:
+
+- `drivers` as `DriverData[]` from analysis API
+- Controlled `selectedDriver` + `setSelectedDriver`
+- `isLoading` while fetching drivers
+
+Report tile: `drivers_map` — tile resolves analysis id, fetches drivers, passes list + selection (see EmbeddedAnalysisSelector pattern).
+
+Requires: `drivers`; `isLoading`; `selectedDriver`; `setSelectedDriver`.
+
+Empty/loading: `isLoading` shows overlay; empty `drivers` leaves map without badges.

package/src/components/widgets/DriversComparisonChart/AGENT.md

@@ -0,0 +1,18 @@
+# DriversComparisonChart
+
+Renders: target vs drivers backtests chart with ChartAreaInteractive plus table; row click toggles series visibility.
+
+Use when: drivers comparison tab with normalized target and driver series from backtests payload.
+Not when: geographic map or performance horizons — use DriverMap or PerformanceChart.
+
+Host provides:
+
+- `payload`: BacktestsComponentPayload from platform SDK (host fetch per analysis)
+- Optional `datasetHistorical` overlay
+- `seriesInitKey` when selected analysis changes
+
+Report tile: Not used in report tiles.
+
+Requires: `payload` — target + driver normalized_series; `loading` / `chartLoading` — spinners; `seriesInitKey` — reset visible series on analysis change; `runAnalysisHint` / `statusHint` — empty/error text.
+
+Empty/loading: loading props shimmer chart; null `payload` with `runAnalysisHint` prompts to run analysis.

package/src/components/widgets/PerformanceChart/AGENT.md

@@ -0,0 +1,18 @@
+# PerformanceChart
+
+Renders: forecast performance on ChartAreaInteractive — per-horizon tab (24m window, MAE/MAPE table) and spaghetti tab (all horizons overlaid).
+
+Use when: dataset performance tab with horizon selector and error metrics.
+Not when: simple forecast card or driver backtests — use ChartAreaInteractive or DriversComparisonChart.
+
+Host provides:
+
+- `performanceData` (PerformanceChartPayload) and `historicalData` from performance API
+- Analysis selection and fetch outside widget
+- Optional `forecastData`, `customPerformanceMatrix`, `userSeries` for spaghetti
+
+Report tile: Not used in report tiles.
+
+Requires: `performanceData` — model/drift forecasts and metrics; `historicalData` — baseline series; `loading` / `chartLoading` / `performanceDataLoading` — spinners; `runAnalysisHint` / `statusHint` — empty states.
+
+Empty/loading: loading props show shimmer/spinner; null `performanceData` with `runAnalysisHint` prompts to run analysis.

package/src/components/widgets/SidebarDatasetsItemsGrouped/AGENT.md

@@ -0,0 +1,18 @@
+# SidebarDatasetsItemsGrouped
+
+Renders: expandable sidebar groups of datasets (by target type, regions, or categories).
+
+Use when: app shell needs grouped dataset navigation.
+Not when: in-page or report content (no sidebar slot).
+
+Host provides:
+
+- `datasets` list (`SidebarDatasetsItemsGroupedDataset`)
+- `groupBy`, `selectedDatasetId`, `onDatasetClick`
+- Optional `preItems` / `postItems`, `defaultExpandedGroupNames`
+
+Report tile: Not used in report tiles.
+
+Requires: `datasets`; `groupBy`; `onDatasetClick` for navigation.
+
+Empty/loading: empty `datasets` renders no groups; loading handled by host before pass-in.

package/src/contexts/chat-context.tsx

@@ -39,6 +39,12 @@ export type AddChatMessageOptions = {
   inProgress?: boolean;
 };
 
+export type UpdateChatMessagePatch = {
+  role?: MessageRole;
+  text?: string;
+  inProgress?: boolean;
+};
+
 export interface ChatContextType {
   /** Returns the new session id, or undefined if no user / not created. */
   newChat: (scopeId: string) => string | undefined;
@@ -55,6 +61,12 @@ export interface ChatContextType {
     chatId: string,
     messageId: string,
   ) => void;
+  updateMessageById: (
+    scopeId: string,
+    chatId: string,
+    messageId: string,
+    patch: UpdateChatMessagePatch,
+  ) => void;
   sendMessage: (
     scopeId: string,
     message: string | ChatSendMessagePayload,
@@ -370,6 +382,49 @@ export function ChatProvider({
     [userSwitchKey],
   );
 
+  const updateMessageById = useCallback(
+    (
+      scopeId: string,
+      chatId: string,
+      messageId: string,
+      patch: UpdateChatMessagePatch,
+    ) => {
+      if (userSwitchKey === null) return;
+      setChats(prev => {
+        const scopeChats = prev[scopeId] ?? [];
+        const updatedChats = scopeChats.map(chat => {
+          if (chat.session_id !== chatId) return chat;
+          return {
+            ...chat,
+            messages: chat.messages.map(message => {
+              if (message.id !== messageId) return message;
+              const next: Message = { ...message };
+              if (patch.role != null) {
+                next.role = patch.role;
+              }
+              if (patch.text != null) {
+                next.text = stripJsonDashboardFences(patch.text);
+              }
+              if (patch.inProgress === true) {
+                next.inProgress = true;
+              } else if (
+                patch.inProgress === false ||
+                (patch.role != null && patch.role !== MessageRole.SYSTEM)
+              ) {
+                delete next.inProgress;
+              }
+              return next;
+            }),
+          };
+        });
+        const chatsKey = getChatsKey(scopeId);
+        LS.set(chatsKey, updatedChats);
+        return { ...prev, [scopeId]: updatedChats };
+      });
+    },
+    [userSwitchKey],
+  );
+
   const sendMessage = useCallback(
     async (
       scopeId: string,
@@ -487,6 +542,7 @@ export function ChatProvider({
         setCurrentChatId,
         addMessage,
         removeMessageById,
+        updateMessageById,
         sendMessage,
         getChatsForScopeId,
         getCurrentChatId,
@@ -572,6 +628,7 @@ export function useChatsForScopeId(scopeId: string) {
     newChat,
     addMessage,
     removeMessageById,
+    updateMessageById,
     sendMessage,
     deleteChat,
   } = useChats();
@@ -595,6 +652,11 @@ export function useChatsForScopeId(scopeId: string) {
     ) => addMessage(scopeId, chatId, role, text, options),
     removeMessageById: (chatId: string, messageId: string) =>
       removeMessageById(scopeId, chatId, messageId),
+    updateMessageById: (
+      chatId: string,
+      messageId: string,
+      patch: UpdateChatMessagePatch,
+    ) => updateMessageById(scopeId, chatId, messageId, patch),
     sendMessage: (message: string | ChatSendMessagePayload, chatId?: string) =>
       sendMessage(scopeId, message, chatId),
     deleteChat: (sessionId: string) => deleteChat(scopeId, sessionId),

package/src/docs/pages/ChatSlashCommandsPage.tsx

@@ -28,11 +28,10 @@ const DOCS_SAMPLE_SLASH_ITEMS: SlashCommandItem[] = [
   },
 ];
 
-const SAMPLE_COMMAND_REPLY_TEXT =
-  'Sample command ran via `onSlashItemCommand` — composer cleared, no mention inserted.';
-
 const SAMPLE_COMMAND_PROGRESS_TEXT = 'Running sample command…';
 
+const SAMPLE_COMMAND_SUCCESS_TEXT = '✅ Sample command complete.';
+
 function makeMessage(
   role: MessageRole,
   text: string,
@@ -47,6 +46,33 @@ function makeMessage(
   };
 }
 
+/** Local-state equivalent of chat-context `updateMessageById`. */
+function updateMessageInPlace(
+  messages: Message[],
+  messageId: string,
+  patch: { role?: MessageRole; text?: string; inProgress?: boolean },
+): Message[] {
+  return messages.map(message => {
+    if (message.id !== messageId) return message;
+    const next: Message = { ...message };
+    if (patch.role != null) {
+      next.role = patch.role;
+    }
+    if (patch.text != null) {
+      next.text = patch.text;
+    }
+    if (patch.inProgress === true) {
+      next.inProgress = true;
+    } else if (
+      patch.inProgress === false ||
+      (patch.role != null && patch.role !== MessageRole.SYSTEM)
+    ) {
+      delete next.inProgress;
+    }
+    return next;
+  });
+}
+
 const ASSISTANT_REPLY_TEXT =
   'Demo reply for a normal message. Slash picks with a custom handler skip mention insert.';
 
@@ -88,10 +114,13 @@ export default function ChatSlashCommandsPage() {
     }
     replyTimeoutRef.current = setTimeout(() => {
       replyTimeoutRef.current = null;
-      setMessages(prev => [
-        ...prev.filter(m => m.id !== progressId),
-        makeMessage(MessageRole.ASSISTANT, SAMPLE_COMMAND_REPLY_TEXT),
-      ]);
+      setMessages(prev =>
+        updateMessageInPlace(prev, progressId, {
+          role: MessageRole.ASSISTANT,
+          text: SAMPLE_COMMAND_SUCCESS_TEXT,
+          inProgress: false,
+        }),
+      );
       setIsLoading(false);
     }, 1200);
   }, []);
@@ -110,7 +139,7 @@ export default function ChatSlashCommandsPage() {
   const onSubmit = useCallback(
     (raw: string) => {
       const text = raw.trim();
-      if (!text || isLoading) return;
+      if (!text) return;
 
       if (text === `/${DOCS_SAMPLE_COMMAND_ID}`) {
         runSampleCommand();
@@ -132,7 +161,7 @@ export default function ChatSlashCommandsPage() {
         setIsLoading(false);
       }, 900);
     },
-    [isLoading, runSampleCommand],
+    [runSampleCommand],
   );
 
   return (
@@ -140,7 +169,7 @@ export default function ChatSlashCommandsPage() {
       <AppPageHeader
         breadcrumbs={[{ label: 'Chat' }, { label: 'Chat slash commands' }]}
         title="Chat slash commands"
-        subheader={`Slash palette uses TipTap Mention with "/" as the trigger. Pass slashCommandItems from the app; optional onSlashItemCommand can clear the composer and run an action instead of inserting a mention. Long-running handlers can append a SYSTEM message with inProgress while work is in flight, then remove it when done.`}
+        subheader={`Slash palette uses TipTap Mention with "/" as the trigger. Pass slashCommandItems from the app; optional onSlashItemCommand can clear the composer and run an action instead of inserting a mention. Long-running handlers can append a SYSTEM message with inProgress while work is in flight, then update it in place (e.g. via updateMessageById) to a final assistant message when done.`}
         actions={
           <DocsHeaderActions slashCommandItems={DOCS_SAMPLE_SLASH_ITEMS} />
         }
@@ -154,10 +183,9 @@ export default function ChatSlashCommandsPage() {
           shell below: scrolling history, empty state, disclaimer, composer.
           Type <kbd className="font-mono">/</kbd> at line start or after a
           space; pick <kbd className="font-mono">sample-command</kbd> to run the
-          custom handler (shows a transient{' '}
-          <kbd className="font-mono">inProgress</kbd> shimmer while the demo
-          action runs), or send <kbd className="font-mono">/sample-command</kbd>{' '}
-          with Enter.
+          custom handler (shows an <kbd className="font-mono">inProgress</kbd>{' '}
+          shimmer, then updates the same message to a success assistant reply),
+          or send <kbd className="font-mono">/sample-command</kbd> with Enter.
         </p>
         <ChatChrome
           showResizeHandle={false}
@@ -185,7 +213,7 @@ export default function ChatSlashCommandsPage() {
           emptyState={{
             title: 'Try a slash command',
             description:
-              'Pick sample-command from the palette or send /sample-command — onSlashItemCommand clears the composer, shows an inProgress placeholder, then posts the demo reply.',
+              'Pick sample-command from the palette or send /sample-command — inProgress placeholder shimmers, then becomes "✅ Sample command complete." in the same slot.',
           }}
         />
       </PageContentSection>