@lowdefy/blocks-antd-x 5.5.1 → 6.0.0

package/dist/blocks/AgentChat/AgentChat.js

@@ -12,30 +12,39 @@
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.
-*/ import React, { useRef, useMemo, useEffect, useState } from 'react';
+*/ import React, { useRef, useMemo, useEffect, useState, useCallback } from 'react';
 import { useChat } from '@ai-sdk/react';
 import { lastAssistantMessageIsCompleteWithApprovalResponses, lastAssistantMessageIsCompleteWithToolCalls } from 'ai';
 import { FileCard, Prompts, Sender } from '@ant-design/x';
 import { Button } from 'antd';
 import { PaperClipOutlined } from '@ant-design/icons';
-import { type } from '@lowdefy/helpers';
+import { isReserved, setKey, type } from '@lowdefy/helpers';
+import getLegacyObjectUrl from '@lowdefy/blocks-files/utils/getLegacyObjectUrl.js';
+import getUploadPolicy from '@lowdefy/blocks-files/utils/getUploadPolicy.js';
+import uploadFile from '@lowdefy/blocks-files/utils/uploadFile.js';
 import { getFileCardType, getFileCardIcon } from './fileCardUtils.js';
 import DrawerWrapper from './DrawerWrapper.js';
 import createLowdefyChatTransport from './LowdefyChatTransport.js';
 import MessageList from './MessageList.js';
 import useAgentEvents, { collectExternalEventIds } from './useAgentEvents.js';
 import WelcomeScreen from './WelcomeScreen.js';
-function AgentChat({ blockId, components: { Icon }, methods, pageId, properties }) {
-    const { agentId, urlQuery, sharedState, welcome, messageDisplay, sender, conversationId, messages: externalMessages, display, drawer: drawerConfig, suggestions } = properties;
+function AgentChat({ blockId, components: { Icon, Link }, events, methods, pageId, properties }) {
+    const { agentId, urlQuery, sharedState, welcome, messageDisplay, sender, conversationId, feedbackValues: storedFeedbackValues, messages: externalMessages, display, drawer: drawerConfig, suggestions } = properties;
     const senderRef = useRef(null);
     const finishMetaRef = useRef(null);
     const fileInputRef = useRef(null);
     const [attachedFiles, setAttachedFiles] = useState([]);
+    const [dragOver, setDragOver] = useState(false);
+    // Controlled composer value, so a starter prompt (or the setInput method) can
+    // fill the box, and a send can leave typed text in place when it is rejected.
+    const [inputValue, setInputValue] = useState('');
     // Mirror the operator-evaluated sharedState object into a ref so transport.body()
     // sees the freshest value at send time without re-constructing the transport.
     const sharedStateRef = useRef(null);
     sharedStateRef.current = type.isObject(sharedState) && Object.keys(sharedState).length > 0 ? sharedState : null;
     const attachmentsConfig = sender?.attachments;
+    const uploadPolicyRequestId = attachmentsConfig?.uploadPolicyRequestId ?? attachmentsConfig?.s3PostPolicyRequestId;
+    const downloadPolicyRequestId = attachmentsConfig?.downloadPolicyRequestId;
     const switchConfigs = sender?.switches ?? [];
     const [headerOpen, setHeaderOpen] = useState(sender?.header?.open ?? true);
     const [switchState, setSwitchState] = useState(()=>{
@@ -68,6 +77,16 @@ function AgentChat({ blockId, components: { Icon }, methods, pageId, properties
     ]);
     const bubbleListRef = useRef(null);
     const { messages, sendMessage, status, stop, addToolApprovalResponse, addToolOutput, setMessages, regenerate, clearError } = useChat({
+        // Key the Chat instance by conversation: without an id, useChat creates its
+        // Chat once per mount and CAPTURES that transport — the transport rebuilt by
+        // the useMemo above on a conversationId change is silently ignored, so every
+        // send posts under the mount-time conversationId. Continuing a conversation
+        // the app selected later then persists the whole transcript under the stale
+        // id (a duplicate conversation doc). Keying by id makes useChat swap Chat
+        // instances — and adopt the rebuilt transport — when the conversation
+        // changes; the clear-on-id-change and external-message-sync effects below
+        // compose with the swap unchanged.
+        id: effectiveConversationId,
         transport,
         experimental_throttle: 50,
         sendAutomaticallyWhen: (args)=>lastAssistantMessageIsCompleteWithToolCalls(args) || lastAssistantMessageIsCompleteWithApprovalResponses(args),
@@ -84,8 +103,17 @@ function AgentChat({ blockId, components: { Icon }, methods, pageId, properties
                     const writable = {};
                     const ignored = [];
                     for (const [key, value] of Object.entries(updates)){
-                        if (allowedKeys.has(key)) writable[key] = value;
-                        else ignored.push(key);
+                        if (!allowedKeys.has(key)) {
+                            ignored.push(key);
+                            continue;
+                        }
+                        // Same policy as a non-allowlisted key: drop it and report it back
+                        // so the model can self-correct on the next turn.
+                        if (isReserved(key)) {
+                            ignored.push(key);
+                            continue;
+                        }
+                        setKey(writable, key, value);
                     }
                     if (Object.keys(writable).length > 0) {
                         await methods.triggerEvent({
@@ -115,6 +143,13 @@ function AgentChat({ blockId, components: { Icon }, methods, pageId, properties
             }
         },
         onError: (error)=>{
+            // A request that fails after the stream's `start` chunk leaves the
+            // assistant shell the SDK pushed on that chunk — id set, parts: [] — in
+            // the message list. Left there, every later send fails UIMessage
+            // validation ("Message must contain at least one part") and the
+            // conversation is dead until a reload. Drop empty shells so the user can
+            // simply try again; there is nothing in them to show or to send.
+            setMessages((prev)=>prev.filter((m)=>m.role !== 'assistant' || (m.parts?.length ?? 0) > 0));
             methods.triggerEvent({
                 name: 'onError',
                 event: {
@@ -140,6 +175,21 @@ function AgentChat({ blockId, components: { Icon }, methods, pageId, properties
             });
         }
     });
+    // The control is otherwise write-only: it reports a rating and immediately forgets it,
+    // so the thumb un-highlights on the next render and the message looks unrated. This holds
+    // what was clicked THIS visit; the block still persists nothing itself.
+    const [feedbackValues, setFeedbackValues] = useState({});
+    // Ratings the app already knows about, keyed by message id — what a reload or a
+    // conversation switch would otherwise lose, since the block stores nothing. A click this
+    // visit wins over the stored value, so the thumb responds immediately and a rating the
+    // user has just withdrawn is not re-lit by a stale prop.
+    // Not memoised: the property arrives from operators that rebuild it every render, so a
+    // dependency on it would miss every time — the same reason the message sync below
+    // compares by count and id rather than by reference.
+    const effectiveFeedbackValues = {
+        ...storedFeedbackValues ?? {},
+        ...feedbackValues
+    };
     // Clear messages when conversationId changes so the new conversation starts clean.
     // Developers load saved messages via the messages property if needed.
     const prevConversationIdRef = useRef(effectiveConversationId);
@@ -147,6 +197,9 @@ function AgentChat({ blockId, components: { Icon }, methods, pageId, properties
         if (effectiveConversationId !== prevConversationIdRef.current) {
             prevConversationIdRef.current = effectiveConversationId;
             setMessages([]);
+            // Ratings clicked in the thread being left must not carry over: they are keyed by
+            // message id, and the incoming conversation supplies its own through feedbackValues.
+            setFeedbackValues({});
         }
     }, [
         effectiveConversationId,
@@ -198,7 +251,7 @@ function AgentChat({ blockId, components: { Icon }, methods, pageId, properties
                 sendMessage({
                     text: args.text,
                     ...args.files ? {
-                        experimental_attachments: args.files
+                        files: args.files
                     } : {},
                     ...args.metadata ? {
                         metadata: args.metadata
@@ -206,6 +259,9 @@ function AgentChat({ blockId, components: { Icon }, methods, pageId, properties
                 });
             }
         });
+        methods.registerMethod('setInput', (args)=>{
+            setInputValue(typeof args?.text === 'string' ? args.text : '');
+        });
         methods.registerMethod('clearMessages', ()=>{
             setMessages([]);
         });
@@ -237,19 +293,36 @@ function AgentChat({ blockId, components: { Icon }, methods, pageId, properties
                 }
             ]
         });
-        if (attachmentsConfig?.s3PostPolicyRequestId) {
+        if (uploadPolicyRequestId) {
+            if (attachmentsConfig?.s3PostPolicyRequestId) {
+                console.warn('AgentChat attachments property "s3PostPolicyRequestId" is deprecated. Use "uploadPolicyRequestId" instead.');
+            }
             methods.registerEvent({
-                name: '__getS3PostPolicy',
+                name: '__getUploadPolicy',
                 actions: [
                     {
-                        id: '__getS3PostPolicy',
+                        id: '__getUploadPolicy',
                         type: 'Request',
                         params: [
-                            attachmentsConfig.s3PostPolicyRequestId
+                            uploadPolicyRequestId
                         ]
                     }
                 ]
             });
+            if (downloadPolicyRequestId) {
+                methods.registerEvent({
+                    name: '__getDownloadPolicy',
+                    actions: [
+                        {
+                            id: '__getDownloadPolicy',
+                            type: 'Request',
+                            params: [
+                                downloadPolicyRequestId
+                            ]
+                        }
+                    ]
+                });
+            }
         }
     }, []);
     useAgentEvents({
@@ -276,48 +349,83 @@ function AgentChat({ blockId, components: { Icon }, methods, pageId, properties
             reader.readAsDataURL(file);
         });
     }
-    async function uploadFileToS3(file) {
-        const { name, size, type: fileType } = file;
-        const s3PostPolicyResponse = await methods.triggerEvent({
-            name: '__getS3PostPolicy',
-            event: {
-                file: {
-                    name,
-                    size,
-                    type: fileType
-                }
-            }
+    async function uploadFileToStorage(file) {
+        const { name, type: fileType } = file;
+        const descriptor = await getUploadPolicy({
+            methods,
+            file
         });
-        if (s3PostPolicyResponse.success !== true) {
-            throw new Error('S3 post policy request failed.');
-        }
-        const { url, fields = {} } = s3PostPolicyResponse.responses.__getS3PostPolicy.response[0];
-        const { key } = fields;
-        const formData = new FormData();
-        Object.keys(fields).forEach((field)=>{
-            formData.append(field, fields[field]);
+        await uploadFile({
+            descriptor,
+            file
         });
-        formData.append('file', file);
-        await new Promise((resolve, reject)=>{
-            const xhr = new XMLHttpRequest();
-            xhr.addEventListener('load', ()=>{
-                if (xhr.status >= 200 && xhr.status < 300) {
-                    resolve();
-                } else {
-                    reject(new Error(`S3 upload failed with status ${xhr.status}`));
+        // The model provider fetches this URL, so resolve it through the download
+        // request when configured (stable public URL or signed URL). Otherwise
+        // fall back to the legacy unsigned object URL from the descriptor.
+        let objectUrl;
+        if (downloadPolicyRequestId) {
+            const response = await methods.triggerEvent({
+                name: '__getDownloadPolicy',
+                event: {
+                    file: {
+                        bucket: descriptor.bucket,
+                        key: descriptor.key,
+                        name,
+                        type: fileType
+                    }
                 }
             });
-            xhr.addEventListener('error', ()=>reject(new Error('S3 upload network error')));
-            xhr.open('POST', url);
-            xhr.send(formData);
-        });
-        const objectUrl = url.endsWith('/') ? `${url}${key}` : `${url}/${key}`;
+            if (response.success !== true) {
+                throw new Error('Download policy request failed.');
+            }
+            objectUrl = response.responses.__getDownloadPolicy.response[0];
+        } else {
+            objectUrl = getLegacyObjectUrl({
+                descriptor
+            });
+        }
         return {
             url: objectUrl,
             mediaType: fileType,
             filename: name
         };
     }
+    // One intake for every way a file arrives — the paperclip picker, a
+    // clipboard paste, a drag-and-drop — so the accept list and size cap apply
+    // to all of them, not just the picker's native dialog. Pasted clipboard
+    // images all arrive as "image.png" (every browser), and the attached list
+    // is keyed by name + size, so those get a unique name.
+    function acceptsFile(file) {
+        const accept = attachmentsConfig?.accept;
+        if (!accept) return true;
+        const name = (file.name || '').toLowerCase();
+        const mime = (file.type || '').toLowerCase();
+        return accept.split(',').map((t)=>t.trim().toLowerCase()).filter(Boolean).some((t)=>{
+            if (t.startsWith('.')) return name.endsWith(t);
+            if (t.endsWith('/*')) return mime.startsWith(t.slice(0, -1));
+            return mime === t;
+        });
+    }
+    function addFiles(incoming, { pasted = false } = {}) {
+        const files = Array.from(incoming ?? []).filter((f)=>acceptsFile(f) && !(attachmentsConfig?.maxSize && f.size > attachmentsConfig.maxSize));
+        if (files.length === 0) return;
+        const named = files.map((f)=>{
+            if (!pasted || !/^image\.\w+$/i.test(f.name)) return f;
+            const ext = f.name.split('.').pop();
+            return new File([
+                f
+            ], `pasted-${Date.now()}.${ext}`, {
+                type: f.type
+            });
+        });
+        setAttachedFiles((prev)=>[
+                ...prev,
+                ...named
+            ]);
+    }
+    function dragHasFiles(e) {
+        return Array.from(e.dataTransfer?.types ?? []).includes('Files');
+    }
     async function handleSend(text) {
         if (!text.trim() && attachedFiles.length === 0) return;
         const filesMeta = attachedFiles.map((file)=>({
@@ -343,9 +451,9 @@ function AgentChat({ blockId, components: { Icon }, methods, pageId, properties
                     text
                 }
             ];
-            if (attachmentsConfig?.s3PostPolicyRequestId) {
+            if (uploadPolicyRequestId) {
                 try {
-                    const uploadResults = await Promise.all(attachedFiles.map((file)=>uploadFileToS3(file)));
+                    const uploadResults = await Promise.all(attachedFiles.map((file)=>uploadFileToStorage(file)));
                     for (const result of uploadResults){
                         parts.push({
                             type: 'file',
@@ -358,7 +466,7 @@ function AgentChat({ blockId, components: { Icon }, methods, pageId, properties
                     methods.triggerEvent({
                         name: 'onError',
                         event: {
-                            message: error.message ?? 'File upload to S3 failed.'
+                            message: error.message ?? 'File upload failed.'
                         }
                     });
                     return;
@@ -378,7 +486,12 @@ function AgentChat({ blockId, components: { Icon }, methods, pageId, properties
                 text
             });
         }
-        senderRef.current?.clear();
+        // Empty the composer here, after the sends and downstream of both the
+        // onBeforeSend cancellation return and the upload await, so a send that was
+        // rejected or failed to upload leaves the user's text in the box. Resetting
+        // from the Sender's onSubmit handler instead would silently lose typed input
+        // on every rejected send.
+        setInputValue('');
     }
     function handleStop() {
         stop();
@@ -394,6 +507,12 @@ function AgentChat({ blockId, components: { Icon }, methods, pageId, properties
             text: prompt.label
         });
     }
+    // A two-track welcome starter fills the composer instead of sending, so a
+    // generic shipped default is an editable first draft rather than a message the
+    // user never meant to send. Reuses the controlled Sender value.
+    function handleWelcomePromptFill(text) {
+        setInputValue(typeof text === 'string' ? text : '');
+    }
     function handleSuggestionClick(suggestion) {
         methods.triggerEvent({
             name: 'onSuggestionClick',
@@ -431,7 +550,40 @@ function AgentChat({ blockId, components: { Icon }, methods, pageId, properties
         messages
     ]);
     const activeSuggestions = agentSuggestions ?? suggestions;
+    // A link in an answer was a plain anchor: a full browser navigation out of the
+    // conversation, with no way for an app to do anything else with it. Default is only
+    // prevented when the app actually handles onLinkClick — otherwise the link keeps
+    // navigating, so wiring nothing changes nothing.
+    //
+    // Modified and non-primary clicks are never intercepted: open-in-new-tab is a
+    // reasonable thing to do with a citation, and preventing it would be a regression.
+    const interceptLinks = Boolean(events?.onLinkClick);
+    // Stable identity: MessageBubble memoises its markdown component map on this, and the map
+    // is rebuilt on every streaming chunk otherwise — remounting every link in the answer as
+    // it streams.
+    const handleLinkClick = useCallback(({ href, text, domEvent })=>{
+        if (!interceptLinks || domEvent.defaultPrevented || domEvent.button !== 0 || domEvent.metaKey || domEvent.ctrlKey || domEvent.shiftKey || domEvent.altKey) {
+            return;
+        }
+        // Prevented synchronously: Link checks defaultPrevented immediately after calling
+        // this, and an external anchor's default fires before any async work could run.
+        domEvent.preventDefault();
+        methods.triggerEvent({
+            name: 'onLinkClick',
+            event: {
+                href,
+                text
+            }
+        });
+    }, [
+        interceptLinks,
+        methods
+    ]);
     function handleFeedback({ messageId, rating }) {
+        setFeedbackValues((prev)=>({
+                ...prev,
+                [messageId]: rating
+            }));
         const message = messages.find((msg)=>msg.id === messageId);
         const messageContent = message?.parts?.filter((part)=>part.type === 'text').map((part)=>part.text).join('') ?? '';
         methods.triggerEvent({
@@ -502,7 +654,7 @@ function AgentChat({ blockId, components: { Icon }, methods, pageId, properties
             minHeight: 0,
             padding: '16px 0'
         }
-    }, isEmpty ? /*#__PURE__*/ React.createElement(WelcomeScreen, {
+    }, isEmpty && !welcome?.tracks ? /*#__PURE__*/ React.createElement(WelcomeScreen, {
         config: welcome,
         onPromptClick: handlePromptClick
     }) : /*#__PURE__*/ React.createElement(MessageList, {
@@ -510,8 +662,13 @@ function AgentChat({ blockId, components: { Icon }, methods, pageId, properties
         messages: messages,
         isStreaming: isBusy,
         config: messageDisplay,
+        welcome: welcome,
+        onWelcomePromptFill: handleWelcomePromptFill,
         addToolApprovalResponse: addToolApprovalResponse,
         onFeedback: handleFeedback,
+        onLinkClick: handleLinkClick,
+        Link: Link,
+        feedbackValues: effectiveFeedbackValues,
         onRegenerate: handleRegenerate,
         onDelete: handleDelete,
         onEditMessage: handleEditMessage,
@@ -530,8 +687,27 @@ function AgentChat({ blockId, components: { Icon }, methods, pageId, properties
         wrap: true
     })), /*#__PURE__*/ React.createElement("div", {
         style: {
-            padding: '8px 16px 24px'
-        }
+            padding: '8px 16px 24px',
+            borderRadius: 12,
+            outline: dragOver ? '2px dashed currentColor' : 'none',
+            outlineOffset: -6,
+            transition: 'outline-color 120ms'
+        },
+        // Drag-in lands in the same intake as the picker and paste. Only
+        // react to drags carrying files, so text selections dragged across
+        // the composer are left to the textarea.
+        onDragOver: attachmentsConfig?.enabled ? (e)=>{
+            if (!dragHasFiles(e)) return;
+            e.preventDefault();
+            if (!dragOver) setDragOver(true);
+        } : undefined,
+        onDragLeave: attachmentsConfig?.enabled ? ()=>setDragOver(false) : undefined,
+        onDrop: attachmentsConfig?.enabled ? (e)=>{
+            if (!dragHasFiles(e)) return;
+            e.preventDefault();
+            setDragOver(false);
+            addFiles(e.dataTransfer.files);
+        } : undefined
     }, attachmentsConfig?.enabled && attachedFiles.length > 0 && /*#__PURE__*/ React.createElement(FileCard.List, {
         style: {
             marginBottom: 4
@@ -565,20 +741,22 @@ function AgentChat({ blockId, components: { Icon }, methods, pageId, properties
         accept: attachmentsConfig.accept,
         multiple: true,
         onChange: (e)=>{
-            const files = Array.from(e.target.files);
-            const valid = files.filter((f)=>!(attachmentsConfig.maxSize && f.size > attachmentsConfig.maxSize));
-            setAttachedFiles((prev)=>[
-                    ...prev,
-                    ...valid
-                ]);
+            addFiles(e.target.files);
             e.target.value = '';
         }
     }), /*#__PURE__*/ React.createElement(Sender, {
         ref: senderRef,
+        value: inputValue,
+        onChange: setInputValue,
         placeholder: sender?.placeholder ?? methods.translate('agent.sender.placeholder'),
         submitType: sender?.submitType ?? 'enter',
         allowSpeech: sender?.allowSpeech ?? false,
         onSubmit: handleSend,
+        // Clipboard paste (a screenshot, a copied file) attaches like the
+        // paperclip does.
+        onPasteFile: attachmentsConfig?.enabled ? (files)=>addFiles(files, {
+                pasted: true
+            }) : undefined,
         onCancel: handleStop,
         loading: isBusy,
         prefix: attachmentsConfig?.enabled ? /*#__PURE__*/ React.createElement(Button, {
@@ -612,7 +790,6 @@ function AgentChat({ blockId, components: { Icon }, methods, pageId, properties
 }
 AgentChat.meta = {
     category: 'display',
-    icons: [],
-    styles: []
+    icons: []
 };
 export default AgentChat;

package/dist/blocks/AgentChat/LowdefyChatTransport.js

@@ -14,7 +14,9 @@
   limitations under the License.
 */ import { DefaultChatTransport } from 'ai';
 function createLowdefyChatTransport({ pageId, agentId, conversationId, urlQuery, sharedStateRef }) {
-    const base = `/api/agent/${pageId}/${agentId}`;
+    // The server route takes the last path segment as the agentId — module-scoped
+    // agent ids contain '/', so encode the agentId into a single segment.
+    const base = `/api/agent/${pageId}/${encodeURIComponent(agentId)}`;
     const api = conversationId ? `${base}?conversationId=${encodeURIComponent(conversationId)}` : base;
     return new DefaultChatTransport({
         api,

package/dist/blocks/AgentChat/MessageBubble.js

@@ -101,6 +101,52 @@ function resolveToolResultMode(toolResultDisplay, toolName) {
     }
     return 'summary';
 }
+// Plain link text arrives as a string, but any inline formatting makes it an element tree —
+// so it is flattened rather than reported as absent.
+function linkText(children) {
+    if (typeof children === 'string') return children;
+    if (typeof children === 'number') return String(children);
+    if (Array.isArray(children)) return children.map(linkText).join('');
+    if (/*#__PURE__*/ React.isValidElement(children)) return linkText(children.props?.children);
+    return '';
+}
+// An in-app path renders through the app's Link, so following a citation is a client-side
+// route rather than a reload that drops the conversation. Anything with a scheme opens in a
+// new tab for the same reason. Both still report the click, so an app that handles
+// onLinkClick can show the target in place instead.
+function MarkdownLink({ Link, onLinkClick }) {
+    return function MarkdownAnchor({ href, children, ...props }) {
+        if (!href) return /*#__PURE__*/ React.createElement("span", props, children);
+        const text = linkText(children);
+        const handleClick = (domEvent)=>onLinkClick?.({
+                href,
+                text,
+                domEvent
+            });
+        const external = /^[a-z][a-z0-9+.-]*:/i.test(href) || href.startsWith('//');
+        // A fragment cannot be expressed as a pageId link, so it keeps the anchor.
+        const inApp = !external && href.startsWith('/') && !href.includes('#');
+        if (!inApp || !Link) {
+            return /*#__PURE__*/ React.createElement("a", {
+                ...props,
+                href: href,
+                target: external ? '_blank' : undefined,
+                rel: external ? 'noopener noreferrer' : undefined,
+                onClick: handleClick
+            }, children);
+        }
+        // `pageId`, not `href`: Link renders a plain anchor for href and url — its new-origin form —
+        // and only routes client-side for a pageId. Passing the path as href therefore went through
+        // Link and still reloaded the page, dropping the conversation this exists to preserve.
+        const [pathname, search = ''] = href.slice(1).split('?');
+        return /*#__PURE__*/ React.createElement(Link, {
+            ...props,
+            pageId: pathname,
+            urlQuery: Object.fromEntries(new URLSearchParams(search)),
+            onClick: handleClick
+        }, children);
+    };
+}
 function normalizeActions(actions) {
     if (Array.isArray(actions)) {
         const obj = {};
@@ -111,7 +157,7 @@ function normalizeActions(actions) {
     }
     return actions ?? {};
 }
-function BubbleActions({ actions, textContent, messageId, onFeedback, onRegenerate, onDelete, translate }) {
+function BubbleActions({ actions, textContent, messageId, onFeedback, feedbackValue, onRegenerate, onDelete, translate }) {
     const normalized = normalizeActions(actions);
     const items = [];
     if (normalized.copy) {
@@ -128,6 +174,7 @@ function BubbleActions({ actions, textContent, messageId, onFeedback, onRegenera
             key: 'feedback',
             label: translate('agent.message.feedback'),
             actionRender: ()=>/*#__PURE__*/ React.createElement(Actions.Feedback, {
+                    value: feedbackValue ?? 'default',
                     onChange: (rating)=>onFeedback?.({
                             messageId,
                             rating
@@ -176,7 +223,7 @@ function SourcesDisplay({ sourceParts, config, translate }) {
         expandIconPosition: config?.sourcesDisplay?.expandIconPosition ?? 'end'
     });
 }
-function MessageBubble({ content, isStreaming, parts, config, addToolApprovalResponse, actions, messageId, onFeedback, onRegenerate, onDelete, translate }) {
+function MessageBubble({ content, isStreaming, parts, config, addToolApprovalResponse, actions, messageId, onFeedback, feedbackValue, onLinkClick, Link, onRegenerate, onDelete, translate }) {
     const showThoughtChain = config?.showThoughtChain !== false;
     const showReasoning = config?.showReasoning !== false;
     const reasoningDisplay = config?.reasoningDisplay ?? 'interleaved';
@@ -186,18 +233,22 @@ function MessageBubble({ content, isStreaming, parts, config, addToolApprovalRes
     const renderLatex = config?.renderLatex ?? false;
     const markdownConfig = renderLatex ? getLatexConfig() : undefined;
     const markdownComponents = useMemo(()=>{
-        if (!renderMermaid && !codeHighlighter) return {
-            code: PlainCodeBlock
-        };
+        const code = !renderMermaid && !codeHighlighter ? PlainCodeBlock : RichCodeBlock({
+            renderMermaid,
+            codeHighlighter
+        });
         return {
-            code: RichCodeBlock({
-                renderMermaid,
-                codeHighlighter
+            code,
+            a: MarkdownLink({
+                Link,
+                onLinkClick
             })
         };
     }, [
         renderMermaid,
-        codeHighlighter
+        codeHighlighter,
+        Link,
+        onLinkClick
     ]);
     const normalizedActions = normalizeActions(actions);
     const showActions = Object.values(normalizedActions).some(Boolean) && !isStreaming;
@@ -219,6 +270,7 @@ function MessageBubble({ content, isStreaming, parts, config, addToolApprovalRes
             textContent: content,
             messageId: messageId,
             onFeedback: onFeedback,
+            feedbackValue: feedbackValue,
             onRegenerate: onRegenerate,
             onDelete: onDelete,
             translate: translate
@@ -491,6 +543,7 @@ function MessageBubble({ content, isStreaming, parts, config, addToolApprovalRes
         textContent: allTextContent,
         messageId: messageId,
         onFeedback: onFeedback,
+        feedbackValue: feedbackValue,
         onRegenerate: onRegenerate,
         onDelete: onDelete,
         translate: translate

package/dist/blocks/AgentChat/MessageList.js

@@ -21,6 +21,7 @@ import { hasVisibleContent } from './messageParts.js';
 import MessageBubble from './MessageBubble.js';
 import ThinkingIndicator from './ThinkingIndicator.js';
 import useThinkingMessage from './useThinkingMessage.js';
+import WelcomeScreen from './WelcomeScreen.js';
 function roleAvatar(roleConfig, fallbackIcon) {
     if (roleConfig?.avatar) {
         return /*#__PURE__*/ React.createElement(Avatar, {
@@ -55,7 +56,7 @@ function ThinkingBubbleContent({ bubbleId, config }) {
         label: label
     });
 }
-const MessageList = /*#__PURE__*/ React.forwardRef(function MessageList({ messages, isStreaming, config, addToolApprovalResponse, onFeedback, onRegenerate, onDelete, onEditMessage, translate }, ref) {
+const MessageList = /*#__PURE__*/ React.forwardRef(function MessageList({ messages, isStreaming, config, welcome, onWelcomePromptFill, addToolApprovalResponse, onFeedback, onLinkClick, Link, feedbackValues, onRegenerate, onDelete, onEditMessage, translate }, ref) {
     // Build a lookup map for message parts.
     // Bubble.List's contentRender callback only receives (content, info) where info.key is the
     // item key — it does not receive the full message object with its parts array. This map
@@ -119,10 +120,36 @@ const MessageList = /*#__PURE__*/ React.forwardRef(function MessageList({ messag
             streaming: true
         });
     }
+    // The welcome renders as a leading item so it scrolls up with the transcript
+    // and stays reachable by scrolling back, rather than being swapped out on the
+    // first send. With no messages yet it is simply the only item in the list.
+    if (welcome?.tracks) {
+        items.unshift({
+            key: '__welcome__',
+            role: 'welcome'
+        });
+    }
     return /*#__PURE__*/ React.createElement(Bubble.List, {
         ref: ref,
         items: items,
         role: {
+            welcome: {
+                placement: 'start',
+                variant: 'borderless',
+                style: {
+                    maxWidth: '100%'
+                },
+                styles: {
+                    content: {
+                        width: '100%'
+                    }
+                },
+                contentRender: ()=>/*#__PURE__*/ React.createElement(WelcomeScreen, {
+                        config: welcome,
+                        onFill: onWelcomePromptFill,
+                        inFlow: true
+                    })
+            },
             user: {
                 placement: 'end',
                 variant: config?.roles?.user?.variant ?? 'filled',
@@ -189,6 +216,9 @@ const MessageList = /*#__PURE__*/ React.forwardRef(function MessageList({ messag
                         actions: config?.actions,
                         messageId: info.key,
                         onFeedback: onFeedback,
+                        onLinkClick: onLinkClick,
+                        Link: Link,
+                        feedbackValue: feedbackValues?.[info.key],
                         onRegenerate: onRegenerate,
                         onDelete: onDelete,
                         translate: translate

package/dist/blocks/AgentChat/WelcomeScreen.js

@@ -14,8 +14,95 @@
   limitations under the License.
 */ import React from 'react';
 import { Welcome, Prompts } from '@ant-design/x';
-function WelcomeScreen({ config, onPromptClick }) {
+import { Button } from 'antd';
+// One track: a bordered card holding a heading and a column of starter chips.
+// A chip fills the composer (onFill) rather than sending — a near-miss starter
+// becomes an editable first draft, not a message the user never meant to send.
+function TrackCard({ track, onFill }) {
+    const prompts = track.prompts ?? [];
+    return /*#__PURE__*/ React.createElement("div", {
+        style: {
+            flex: '1 1 240px',
+            border: '1px solid var(--ant-color-border)',
+            borderRadius: 'var(--ant-border-radius-lg)',
+            padding: 16,
+            backgroundColor: 'var(--ant-color-bg-container)',
+            display: 'flex',
+            flexDirection: 'column',
+            gap: 8
+        }
+    }, track.label && /*#__PURE__*/ React.createElement("h5", {
+        style: {
+            margin: '0 0 4px',
+            fontSize: 'var(--ant-font-size-heading-5)',
+            fontWeight: 'var(--ant-font-weight-strong, 600)',
+            lineHeight: 'var(--ant-line-height-heading-5)'
+        }
+    }, track.label), prompts.map((prompt, index)=>{
+        const text = typeof prompt === 'string' ? prompt : prompt.label;
+        return /*#__PURE__*/ React.createElement(Button, {
+            key: index,
+            block: true,
+            // antd buttons are nowrap and size to their longest line; height auto
+            // plus whiteSpace normal lets a sentence-length starter wrap left.
+            style: {
+                height: 'auto',
+                whiteSpace: 'normal',
+                textAlign: 'left',
+                paddingTop: 6,
+                paddingBottom: 6
+            },
+            onClick: ()=>onFill?.(text)
+        }, text);
+    }));
+}
+// The chat empty state. Two modes:
+//   - `config.tracks` present → a two-track teaching panel (ask a question /
+//     build a report), each track a card of fill-the-composer starters. When
+//     `inFlow` it renders top-aligned as a leading item inside the message
+//     scroll area, so it scrolls up with the conversation and stays reachable
+//     by scrolling back rather than being swapped out on the first send.
+//   - otherwise → the flat Welcome + Prompts row, centred, sending on click.
+function WelcomeScreen({ config, onPromptClick, onFill, inFlow }) {
     if (!config) return null;
+    if (config.tracks) {
+        return /*#__PURE__*/ React.createElement("div", {
+            style: inFlow ? {
+                display: 'flex',
+                flexDirection: 'column',
+                gap: 16,
+                width: '100%'
+            } : {
+                flex: 1,
+                display: 'flex',
+                flexDirection: 'column',
+                alignItems: 'center',
+                justifyContent: 'center',
+                gap: 16
+            }
+        }, config.title && /*#__PURE__*/ React.createElement("h3", {
+            style: {
+                margin: 0,
+                fontSize: 'var(--ant-font-size-heading-3)',
+                fontWeight: 'var(--ant-font-weight-strong, 600)',
+                lineHeight: 'var(--ant-line-height-heading-3)'
+            }
+        }, config.title), config.description && /*#__PURE__*/ React.createElement("div", {
+            style: {
+                color: 'var(--ant-color-text-secondary)'
+            }
+        }, config.description), /*#__PURE__*/ React.createElement("div", {
+            style: {
+                display: 'flex',
+                gap: 12,
+                flexWrap: 'wrap'
+            }
+        }, config.tracks.map((track, index)=>/*#__PURE__*/ React.createElement(TrackCard, {
+                key: index,
+                track: track,
+                onFill: onFill
+            }))));
+    }
     const promptItems = (config.prompts ?? []).map((prompt, index)=>({
             key: prompt.key ?? `prompt-${index}`,
             label: prompt.label,

package/dist/blocks/AgentChat/meta.js

@@ -23,7 +23,7 @@
         onUserMessage: 'Trigger when the user sends a message.',
         onConversationStart: 'Trigger once when a conversation starts, on its first user message. Event contains the conversationId (auto-minted when no conversationId property is set).',
         onError: 'Trigger on stream error.',
-        onFeedback: 'Trigger when the user clicks thumbs up or down on a message.',
+        onFeedback: 'Trigger when the user clicks thumbs up or down on a message. Event contains messageId, messageContent and rating, where rating is `like`, `dislike`, or `default` when the user clicks the selected thumb again to clear the rating.',
         onRegenerate: 'Trigger when the user clicks regenerate on a message.',
         onDeleteMessage: 'Trigger when the user deletes a message.',
         onEditMessage: 'Trigger when the user edits and resubmits a message.',
@@ -32,7 +32,8 @@
         onSuggestionClick: 'Trigger when the user clicks a follow-up suggestion.',
         onTitleGenerated: 'Trigger when the agent generates a conversation title.',
         onSwitchChange: 'Trigger when the user toggles a sender switch.',
-        onDataPart: 'Trigger when the agent sends a custom data part. Event contains type, data, and id.'
+        onDataPart: 'Trigger when the agent sends a custom data part. Event contains type, data, and id.',
+        onLinkClick: 'Trigger when the user clicks a link in a message. Event contains href and text. Wiring this event suppresses the default navigation for plain left clicks, so the app can open the target in place; modified clicks (new tab, middle click) always navigate.'
     },
     methods: {
         regenerate: 'Regenerate the last assistant message. Accepts optional args.messageId to regenerate a specific message.',

package/dist/blocks/AgentChat/schema.json

@@ -162,6 +162,10 @@
     "messages": {
       "type": "array"
     },
+    "feedbackValues": {
+      "type": "object",
+      "description": "Ratings already recorded, keyed by message id, each `like` or `dislike`. Restores the thumbs on a conversation the block did not rate this visit. A rating clicked this visit takes precedence."
+    },
     "conversationId": {
       "type": "string",
       "description": "Active conversation ID. When this value changes, messages are automatically cleared."
@@ -186,13 +190,28 @@
         "allowSpeech": { "type": "boolean", "default": false },
         "attachments": {
           "type": "object",
+          "description": "File attachments on the composer. When enabled, files can be picked with the paperclip, pasted from the clipboard (e.g. a screenshot) or dragged onto the composer; accept and maxSize apply to all three.",
           "properties": {
             "enabled": { "type": "boolean" },
-            "accept": { "type": "string" },
-            "maxSize": { "type": "number" },
+            "accept": {
+              "type": "string",
+              "description": "Comma-separated accept list, as for an <input type=\"file\"> — e.g. \"image/*,.pdf\". Applied to picked, pasted and dropped files alike."
+            },
+            "maxSize": {
+              "type": "number",
+              "description": "Maximum file size in bytes. Larger files are silently skipped."
+            },
+            "uploadPolicyRequestId": {
+              "type": "string",
+              "description": "Id of an upload-policy request (e.g. AwsS3PresignedPostPolicy, GcsSignedPostPolicy, AzureBlobUploadSas). When set, files are uploaded to storage and their URLs are sent to the LLM instead of base64 data."
+            },
+            "downloadPolicyRequestId": {
+              "type": "string",
+              "description": "Id of a download request used to resolve the URL of an uploaded attachment. The URL is fetched by the model provider, so it should remain reachable — use public: true on the request for public buckets, or a long expiry. When unset, a legacy unsigned object URL is constructed from the upload response (S3-shaped, deprecated)."
+            },
             "s3PostPolicyRequestId": {
               "type": "string",
-              "description": "Request ID of type AwsS3PresignedPostPolicy. When set, files are uploaded to S3 and their URLs are sent to the LLM instead of base64 data."
+              "description": "Deprecated — use uploadPolicyRequestId instead."
             }
           }
         },

package/dist/blocks/AgentChat/tests/AgentChat.e2e.yaml

@@ -0,0 +1,121 @@
+# Copyright 2020-2026 Lowdefy, Inc
+
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+
+#     http://www.apache.org/licenses/LICENSE-2.0
+
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+id: agent-chat
+type: PageHeaderMenu
+properties:
+  title: AgentChat
+blocks:
+  # Both chats are driven from the messages property, so nothing here calls the agent.
+  - id: chat_wired
+    type: AgentChat
+    properties:
+      agentId: test_agent
+      height: 300
+      conversationId: wired
+      messageDisplay:
+        actions:
+          - feedback
+      messages:
+        - id: w1
+          role: assistant
+          parts:
+            - type: text
+              text: |
+                [in-app link](/agent-chat-target) and [external link](https://example.com)
+                and [**bold** link](/agent-chat-target?tab=two)
+    events:
+      onFeedback:
+        - id: record_rating
+          type: SetState
+          params:
+            last_rating:
+              _event: rating
+      onLinkClick:
+        - id: record_link_click
+          type: SetState
+          params:
+            last_href:
+              _event: href
+            last_text:
+              _event: text
+            click_count:
+              _sum:
+                - _if_none:
+                    - _state: click_count
+                    - 0
+                - 1
+
+  # Seeded from feedbackValues rather than from a click: what a reload or a conversation
+  # switch looks like to an app that stored the rating itself.
+  - id: chat_seeded
+    type: AgentChat
+    properties:
+      agentId: test_agent
+      height: 300
+      conversationId: seeded
+      messageDisplay:
+        actions:
+          - feedback
+      feedbackValues:
+        s1: like
+      messages:
+        - id: s1
+          role: assistant
+          parts:
+            - type: text
+              text: A rated answer.
+    events:
+      onFeedback:
+        - id: record_seeded_rating
+          type: SetState
+          params:
+            seeded_rating:
+              _event: rating
+
+  - id: wired_readout
+    type: Html
+    properties:
+      html:
+        _nunjucks:
+          template: |
+            <span id="readout_href">{{ href }}</span>
+            <span id="readout_text">{{ text }}</span>
+            <span id="readout_count">{{ count or 0 }}</span>
+            <span id="readout_rating">{{ rating }}</span>
+            <span id="readout_seeded_rating">{{ seeded_rating }}</span>
+          on:
+            href:
+              _state: last_href
+            text:
+              _state: last_text
+            count:
+              _state: click_count
+            rating:
+              _state: last_rating
+            seeded_rating:
+              _state: seeded_rating
+
+  - id: chat_unwired
+    type: AgentChat
+    properties:
+      agentId: test_agent
+      height: 300
+      conversationId: unwired
+      messages:
+        - id: u1
+          role: assistant
+          parts:
+            - type: text
+              text: '[in-app link](/agent-chat-target) and [external link](https://example.com)'

package/dist/blocks/AgentChat/tests/AgentChatTarget.e2e.yaml

@@ -0,0 +1,25 @@
+# Copyright 2020-2026 Lowdefy, Inc
+
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+
+#     http://www.apache.org/licenses/LICENSE-2.0
+
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+id: agent-chat-target
+type: PageHeaderMenu
+properties:
+  title: Link target
+blocks:
+  - id: target_marker
+    type: Html
+    properties:
+      # No id on the span: Lowdefy renders the block id into the DOM, so repeating it here
+      # gives two matching elements and a strict-mode violation.
+      html: <span>arrived</span>

package/dist/blocks/AgentConversations/AgentConversations.js

@@ -82,9 +82,6 @@ function AgentConversations({ blockId, methods, properties }) {
 }
 AgentConversations.meta = {
     category: 'display',
-    icons: [],
-    styles: [
-        'blocks/AgentConversations/style.less'
-    ]
+    icons: []
 };
 export default AgentConversations;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/blocks-antd-x",
-  "version": "5.5.1",
+  "version": "6.0.0",
   "license": "Apache-2.0",
   "description": "Lowdefy Ant Design X Blocks",
   "homepage": "https://lowdefy.com",
@@ -41,13 +41,17 @@
     "@ant-design/icons": "6.1.0",
     "@ant-design/x": "2.7.0",
     "@ant-design/x-markdown": "2.7.0",
-    "@lowdefy/block-utils": "5.5.1",
-    "@lowdefy/helpers": "5.5.1",
+    "@lowdefy/block-utils": "6.0.0",
+    "@lowdefy/blocks-files": "6.0.0",
+    "@lowdefy/helpers": "6.0.0",
     "ai": "6.0.176"
   },
   "devDependencies": {
-    "@swc/cli": "0.8.0",
-    "@swc/core": "1.15.18",
+    "@lowdefy/block-dev-e2e": "6.0.0",
+    "@lowdefy/e2e-utils": "6.0.0",
+    "@playwright/test": "1.59.1",
+    "@swc/cli": "0.8.1",
+    "@swc/core": "1.15.32",
     "copyfiles": "2.4.1"
   },
   "peerDependencies": {
@@ -60,6 +64,8 @@
   "scripts": {
     "build": "swc src --out-dir dist --config-file ../../../../.swcrc --cli-config-file ../../../../.swc-cli.json && pnpm copyfiles",
     "clean": "rm -rf dist",
-    "copyfiles": "copyfiles -u 1 \"./src/**/*\" dist -e \"./src/**/*.js\" -e \"./src/**/*.yaml\" -e \"./src/**/*.snap\""
+    "copyfiles": "copyfiles -u 1 \"./src/**/*\" dist -e \"./src/**/*.js\" -e \"./src/**/*.snap\"",
+    "e2e": "playwright test --config e2e/playwright.config.js",
+    "e2e:ui": "playwright test --config e2e/playwright.config.js --ui"
   }
 }

package/dist/blocks/AgentConversations/style.less

@@ -1 +0,0 @@
-// AgentConversations styles — currently uses inline styles and Ant Design X defaults.