@wzrhine/agent 0.0.0-stage → 0.1.0

package/dist/components/message/MessageActions.d.ts

@@ -0,0 +1,63 @@
+import * as React from 'react';
+import type { CapabilityInput } from '@wzrhine/agent-core';
+import type { CopyHandler } from './use-copy.js';
+export type MessageFeedback = 'up' | 'down';
+/** Actions that can be gated by a capability. */
+export type MessageActionKey = 'copy' | 'regenerate' | 'edit' | 'fork' | 'restore' | 'feedback';
+/** Per-action availability: `Capability` (`{ enabled, reason }`) or a boolean. Absent = enabled. */
+export type MessageActionCapabilities = Partial<Record<MessageActionKey, CapabilityInput>>;
+/**
+ * MessageActions: a `role="toolbar"` of icon buttons for one message. A capability without a
+ * callback renders no button (ADR-0011 §4); copy appears when `copyText` is given and either
+ * `onCopy` or the Clipboard API exists. One tab stop: arrow keys / Home / End move between the
+ * buttons (roving tabindex), Tab leaves the toolbar.
+ *
+ * Capabilities: an action whose capability is `enabled: false` still renders (the reader learns
+ * it exists and why it is off) but is `aria-disabled` — it stays focusable and in the roving
+ * order — and its callback is never called. The reason shows in a Tooltip ("name · reason") on
+ * hover / focus and is the button's `aria-describedby` text, so it is not hover-only.
+ *
+ * `onRestoreInput` ("重新编辑本轮输入") puts this turn's input back into the composer; it is a
+ * different action from `onEdit` ("编辑消息"), which edits the sent message.
+ *
+ * Copy feedback: the button's name and icon switch to "已复制" / "复制失败" for 1.2s and a polite
+ * status announces it once. Feedback buttons are toggles (`aria-pressed`); pressing the active
+ * one again sends `null`. No motion beyond the IconButton press; the Tooltip uses its own fade.
+ */
+export type MessageActionsProps = Omit<React.HTMLAttributes<HTMLDivElement>, 'children' | 'onCopy'> & {
+    /** Text copied by the copy action; omit to hide copy. */
+    copyText?: string;
+    onCopy?: CopyHandler;
+    onRegenerate?: () => void;
+    onEdit?: () => void;
+    onFork?: () => void;
+    /** Restore this turn's input into the composer (not the same as `onEdit`). */
+    onRestoreInput?: () => void;
+    feedback?: MessageFeedback | null;
+    onFeedback?: (value: MessageFeedback | null) => void;
+    /** Availability per action; a disabled one is shown `aria-disabled` with its reason. */
+    capabilities?: MessageActionCapabilities;
+    /** Toolbar name; defaults to the copy table. */
+    label?: string;
+    /** Extra trailing buttons (rendered inside the toolbar, part of the roving order). */
+    children?: React.ReactNode;
+};
+export declare const MessageActions: React.ForwardRefExoticComponent<Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "onCopy"> & {
+    /** Text copied by the copy action; omit to hide copy. */
+    copyText?: string;
+    onCopy?: CopyHandler;
+    onRegenerate?: () => void;
+    onEdit?: () => void;
+    onFork?: () => void;
+    /** Restore this turn's input into the composer (not the same as `onEdit`). */
+    onRestoreInput?: () => void;
+    feedback?: MessageFeedback | null;
+    onFeedback?: (value: MessageFeedback | null) => void;
+    /** Availability per action; a disabled one is shown `aria-disabled` with its reason. */
+    capabilities?: MessageActionCapabilities;
+    /** Toolbar name; defaults to the copy table. */
+    label?: string;
+    /** Extra trailing buttons (rendered inside the toolbar, part of the roving order). */
+    children?: React.ReactNode;
+} & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=MessageActions.d.ts.map

package/dist/components/message/MessageActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageActions.d.ts","sourceRoot":"","sources":["../../../src/components/message/MessageActions.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAc,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAMvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,MAAM,CAAC;AAE5C,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAEhG,oGAAoG;AACpG,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC,CAAC;AAE3F;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC,GAAG;IACpG,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI,CAAC;IACrD,wFAAwF;IACxF,YAAY,CAAC,EAAE,yBAAyB,CAAC;IACzC,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B,CAAC;AAsDF,eAAO,MAAM,cAAc;IAtEzB,yDAAyD;eAC9C,MAAM;aACR,WAAW;mBACL,MAAM,IAAI;aAChB,MAAM,IAAI;aACV,MAAM,IAAI;IACnB,8EAA8E;qBAC7D,MAAM,IAAI;eAChB,eAAe,GAAG,IAAI;iBACpB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI;IACpD,wFAAwF;mBACzE,yBAAyB;IACxC,gDAAgD;YACxC,MAAM;IACd,sFAAsF;eAC3E,KAAK,CAAC,SAAS;wCAkK1B,CAAC"}

package/dist/components/message/MessageActions.js

@@ -0,0 +1,83 @@
+'use client';
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from 'react';
+import { IconButton, Tooltip } from '@wzrhine/react';
+import { capability } from '@wzrhine/agent-core';
+import { AgentIcon } from '../../primitives/icons.js';
+import { useAgentMessages } from '../../provider/AgentMessages.js';
+import { cx } from '../../utils/cx.js';
+import { MessageIcon } from './icons.js';
+import { useClipboardAvailable, useCopy } from './use-copy.js';
+/**
+ * One toolbar button. The Tooltip wrapper is always present (enabled only while the action is
+ * off), so a capability flip never remounts the button or drops focus.
+ */
+function ActionButton({ action, label, icon, cap, onPress, pressed, state }) {
+    const t = useAgentMessages().message;
+    const reasonId = React.useId();
+    const off = cap !== undefined && !cap.enabled;
+    const reason = off && cap.reason ? cap.reason : undefined;
+    return (_jsxs(_Fragment, { children: [_jsx(Tooltip, { content: reason ? t.actionUnavailable(label, reason) : label, disabled: !off, children: _jsx(IconButton, { size: "sm", variant: "ghost", label: label, "data-action": action, "data-state": state, pressed: pressed, icon: icon, "aria-disabled": off || undefined, "aria-describedby": reason ? reasonId : undefined, 
+                    // While off the Tooltip shows name + reason; a native title would duplicate it.
+                    title: off ? '' : undefined, onClick: (event) => {
+                        if (off) {
+                            event.preventDefault();
+                            return;
+                        }
+                        onPress();
+                    } }) }), reason && (_jsx("span", { id: reasonId, className: "rl-agent-sr", children: reason }))] }));
+}
+export const MessageActions = React.forwardRef(function MessageActions({ copyText, onCopy, onRegenerate, onEdit, onFork, onRestoreInput, feedback = null, onFeedback, capabilities, label, children, className, onKeyDown, ...rest }, ref) {
+    const t = useAgentMessages().message;
+    const clipboard = useClipboardAvailable();
+    const { state, copy } = useCopy(onCopy);
+    const [active, setActive] = React.useState(0);
+    const root = React.useRef(null);
+    React.useImperativeHandle(ref, () => root.current);
+    const cap = (key) => capability(capabilities?.[key]);
+    const canCopy = copyText !== undefined && (onCopy !== undefined || clipboard);
+    const copyName = state === 'copied' ? t.copied : state === 'failed' ? t.copyFailed : t.copy;
+    // aria-disabled buttons stay in the roving order: they keep focus and explain why they are off.
+    const buttons = () => Array.from(root.current?.querySelectorAll('button:not([disabled])') ?? []);
+    // Keep exactly one button in the tab order; re-applied after every render (buttons may change).
+    React.useLayoutEffect(() => {
+        const list = buttons();
+        const index = Math.min(active, list.length - 1);
+        list.forEach((button, i) => {
+            button.tabIndex = i === index ? 0 : -1;
+        });
+    });
+    const handleKeyDown = (event) => {
+        onKeyDown?.(event);
+        if (event.defaultPrevented)
+            return;
+        const list = buttons();
+        const current = list.indexOf(document.activeElement);
+        if (current === -1)
+            return;
+        let next = current;
+        if (event.key === 'ArrowRight' || event.key === 'ArrowDown')
+            next = (current + 1) % list.length;
+        else if (event.key === 'ArrowLeft' || event.key === 'ArrowUp')
+            next = (current - 1 + list.length) % list.length;
+        else if (event.key === 'Home')
+            next = 0;
+        else if (event.key === 'End')
+            next = list.length - 1;
+        else
+            return;
+        event.preventDefault();
+        setActive(next);
+        list[next]?.focus();
+    };
+    const handleFocus = (event) => {
+        const index = buttons().indexOf(event.target);
+        if (index !== -1)
+            setActive(index);
+    };
+    const hasAny = canCopy || onRegenerate || onEdit || onFork || onRestoreInput || onFeedback || children;
+    if (!hasAny)
+        return null;
+    return (_jsxs("div", { ...rest, ref: root, role: "toolbar", "aria-label": label ?? t.actionsLabel, "aria-orientation": "horizontal", className: cx('rl-agent-actions', className), onKeyDown: handleKeyDown, onFocus: handleFocus, children: [canCopy && (_jsx(ActionButton, { action: "copy", label: copyName, state: state, cap: cap('copy'), icon: _jsx(AgentIcon, { name: state === 'copied' ? 'check' : 'copy' }), onPress: () => void copy(copyText) })), onRegenerate && _jsx(ActionButton, { action: "regenerate", label: t.regenerate, cap: cap('regenerate'), icon: _jsx(AgentIcon, { name: "retry" }), onPress: onRegenerate }), onEdit && _jsx(ActionButton, { action: "edit", label: t.edit, cap: cap('edit'), icon: _jsx(AgentIcon, { name: "edit" }), onPress: onEdit }), onRestoreInput && (_jsx(ActionButton, { action: "restore", label: t.restoreInput, cap: cap('restore'), icon: _jsx(MessageIcon, { name: "restore-input" }), onPress: onRestoreInput })), onFork && _jsx(ActionButton, { action: "fork", label: t.fork, cap: cap('fork'), icon: _jsx(AgentIcon, { name: "fork" }), onPress: onFork }), onFeedback && (_jsxs(_Fragment, { children: [_jsx(ActionButton, { action: "feedback-up", label: t.feedbackUp, cap: cap('feedback'), pressed: feedback === 'up', icon: _jsx(MessageIcon, { name: "thumb-up" }), onPress: () => onFeedback(feedback === 'up' ? null : 'up') }), _jsx(ActionButton, { action: "feedback-down", label: t.feedbackDown, cap: cap('feedback'), pressed: feedback === 'down', icon: _jsx(MessageIcon, { name: "thumb-down" }), onPress: () => onFeedback(feedback === 'down' ? null : 'down') })] })), children, canCopy && (_jsx("span", { className: "rl-agent-sr", role: "status", children: state === 'copied' ? t.copied : state === 'failed' ? t.copyFailed : '' }))] }));
+});
+//# sourceMappingURL=MessageActions.js.map

package/dist/components/message/MessageActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageActions.js","sourceRoot":"","sources":["../../../src/components/message/MessageActions.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AA0D/D;;;GAGG;AACH,SAAS,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAqB;IAC5F,MAAM,CAAC,GAAG,gBAAgB,EAAE,CAAC,OAAO,CAAC;IACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;IAC/B,MAAM,GAAG,GAAG,GAAG,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;IAC9C,MAAM,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1D,OAAO,CACL,8BACE,KAAC,OAAO,IAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,GAAG,YACnF,KAAC,UAAU,IACT,IAAI,EAAC,IAAI,EACT,OAAO,EAAC,OAAO,EACf,KAAK,EAAE,KAAK,iBACC,MAAM,gBACP,KAAK,EACjB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,IAAI,mBACK,GAAG,IAAI,SAAS,sBACb,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;oBAC/C,gFAAgF;oBAChF,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EAC3B,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;wBACjB,IAAI,GAAG,EAAE,CAAC;4BACR,KAAK,CAAC,cAAc,EAAE,CAAC;4BACvB,OAAO;wBACT,CAAC;wBACD,OAAO,EAAE,CAAC;oBACZ,CAAC,GACD,GACM,EACT,MAAM,IAAI,CACT,eAAM,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAC,aAAa,YACxC,MAAM,GACF,CACR,IACA,CACJ,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC,UAAU,CAAsC,SAAS,cAAc,CACzG,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,GAAG,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAC7J,GAAG;IAEH,MAAM,CAAC,GAAG,gBAAgB,EAAE,CAAC,OAAO,CAAC;IACrC,MAAM,SAAS,GAAG,qBAAqB,EAAE,CAAC;IAC1C,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAwB,IAAI,CAAC,CAAC;IACvD,KAAK,CAAC,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAyB,CAAC,CAAC;IAErE,MAAM,GAAG,GAAG,CAAC,GAAqB,EAAE,EAAE,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvE,MAAM,OAAO,GAAG,QAAQ,KAAK,SAAS,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,SAAS,CAAC,CAAC;IAC9E,MAAM,QAAQ,GAAG,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE5F,gGAAgG;IAChG,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAoB,wBAAwB,CAAC,IAAI,EAAE,CAAC,CAAC;IAEpH,gGAAgG;IAChG,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE;QACzB,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YACzB,MAAM,CAAC,QAAQ,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,CAAC,KAA0C,EAAE,EAAE;QACnE,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC;QACnB,IAAI,KAAK,CAAC,gBAAgB;YAAE,OAAO;QACnC,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAkC,CAAC,CAAC;QAC1E,IAAI,OAAO,KAAK,CAAC,CAAC;YAAE,OAAO;QAC3B,IAAI,IAAI,GAAG,OAAO,CAAC;QACnB,IAAI,KAAK,CAAC,GAAG,KAAK,YAAY,IAAI,KAAK,CAAC,GAAG,KAAK,WAAW;YAAE,IAAI,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;aAC3F,IAAI,KAAK,CAAC,GAAG,KAAK,WAAW,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;YAAE,IAAI,GAAG,CAAC,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;aAC3G,IAAI,KAAK,CAAC,GAAG,KAAK,MAAM;YAAE,IAAI,GAAG,CAAC,CAAC;aACnC,IAAI,KAAK,CAAC,GAAG,KAAK,KAAK;YAAE,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;;YAChD,OAAO;QACZ,KAAK,CAAC,cAAc,EAAE,CAAC;QACvB,SAAS,CAAC,IAAI,CAAC,CAAC;QAChB,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;IACtB,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,CAAC,KAAuC,EAAE,EAAE;QAC9D,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAsC,CAAC,CAAC;QAC9E,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,OAAO,IAAI,YAAY,IAAI,MAAM,IAAI,MAAM,IAAI,cAAc,IAAI,UAAU,IAAI,QAAQ,CAAC;IACvG,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,OAAO,CACL,kBACM,IAAI,EACR,GAAG,EAAE,IAAI,EACT,IAAI,EAAC,SAAS,gBACF,KAAK,IAAI,CAAC,CAAC,YAAY,sBAClB,YAAY,EAC7B,SAAS,EAAE,EAAE,CAAC,kBAAkB,EAAE,SAAS,CAAC,EAC5C,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,WAAW,aAEnB,OAAO,IAAI,CACV,KAAC,YAAY,IACX,MAAM,EAAC,MAAM,EACb,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,EAChB,IAAI,EAAE,KAAC,SAAS,IAAC,IAAI,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,GAAI,EAChE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,GAClC,CACH,EACA,YAAY,IAAI,KAAC,YAAY,IAAC,MAAM,EAAC,YAAY,EAAC,KAAK,EAAE,CAAC,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,KAAC,SAAS,IAAC,IAAI,EAAC,OAAO,GAAG,EAAE,OAAO,EAAE,YAAY,GAAI,EAC1J,MAAM,IAAI,KAAC,YAAY,IAAC,MAAM,EAAC,MAAM,EAAC,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAC,SAAS,IAAC,IAAI,EAAC,MAAM,GAAG,EAAE,OAAO,EAAE,MAAM,GAAI,EAC3H,cAAc,IAAI,CACjB,KAAC,YAAY,IAAC,MAAM,EAAC,SAAS,EAAC,KAAK,EAAE,CAAC,CAAC,YAAY,EAAE,GAAG,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAC,WAAW,IAAC,IAAI,EAAC,eAAe,GAAG,EAAE,OAAO,EAAE,cAAc,GAAI,CACnJ,EACA,MAAM,IAAI,KAAC,YAAY,IAAC,MAAM,EAAC,MAAM,EAAC,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAC,SAAS,IAAC,IAAI,EAAC,MAAM,GAAG,EAAE,OAAO,EAAE,MAAM,GAAI,EAC3H,UAAU,IAAI,CACb,8BACE,KAAC,YAAY,IACX,MAAM,EAAC,aAAa,EACpB,KAAK,EAAE,CAAC,CAAC,UAAU,EACnB,GAAG,EAAE,GAAG,CAAC,UAAU,CAAC,EACpB,OAAO,EAAE,QAAQ,KAAK,IAAI,EAC1B,IAAI,EAAE,KAAC,WAAW,IAAC,IAAI,EAAC,UAAU,GAAG,EACrC,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAC1D,EACF,KAAC,YAAY,IACX,MAAM,EAAC,eAAe,EACtB,KAAK,EAAE,CAAC,CAAC,YAAY,EACrB,GAAG,EAAE,GAAG,CAAC,UAAU,CAAC,EACpB,OAAO,EAAE,QAAQ,KAAK,MAAM,EAC5B,IAAI,EAAE,KAAC,WAAW,IAAC,IAAI,EAAC,YAAY,GAAG,EACvC,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAC9D,IACD,CACJ,EACA,QAAQ,EACR,OAAO,IAAI,CACV,eAAM,SAAS,EAAC,aAAa,EAAC,IAAI,EAAC,QAAQ,YACxC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,GAClE,CACR,IACG,CACP,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/components/message/MessageList.d.ts

@@ -0,0 +1,100 @@
+import * as React from 'react';
+import type { MessageView } from '@wzrhine/agent-core';
+import type { AgentMessageProps } from './AgentMessage.js';
+/** Distance from the bottom (px, measured in JS) that still counts as "at the latest content". */
+export declare const FOLLOW_THRESHOLD_PX = 4;
+/** Imperative handle of MessageList. */
+export interface MessageListHandle {
+    /** Scroll to the newest content and resume following (smooth unless motion is reduced). */
+    scrollToLatest: (options?: {
+        smooth?: boolean;
+    }) => void;
+    /** Whether the list currently follows new content. */
+    isFollowing: () => boolean;
+    /** The scrolling viewport element. */
+    viewport: () => HTMLElement | null;
+}
+/**
+ * MessageList (atlas 07): the conversation viewport. It owns its own vertical scroll and decides
+ * when to follow new content; it never moves focus.
+ *
+ * Semantics: a focusable `<section aria-label="对话消息">` (keyboard scrolling) containing an
+ * `<ol>` of messages. Deliberately **not** `role="log"`: a log is an implicit polite live region
+ * and would read streamed text token by token. Announcements come from each AgentMessage's own
+ * throttled status line instead.
+ *
+ * Scroll ownership:
+ * - Follows the bottom while the reader is within `FOLLOW_THRESHOLD_PX` of it (on mount, while
+ *   streaming, when a disclosure grows — content size is watched with ResizeObserver).
+ * - Stops following as soon as the reader moves up: wheel up, touch drag, PageUp / Home /
+ *   ArrowUp on the viewport, scrollbar drag (any scroll that decreases `scrollTop` and was not
+ *   made by the list itself). Resumes when the reader is back at the bottom.
+ * - While not following, JumpToLatest shows, counting messages appended since the reader left.
+ * - A new trailing user message (just sent) scrolls to the latest once.
+ * - Loading earlier messages keeps the reading anchor: the first visible `[data-message-id]` and
+ *   its offset are recorded before `onLoadEarlier` and restored after the prepend.
+ * - `overflow-anchor: none`, so browser scroll anchoring never fights these rules.
+ * - `holdFollow`: while true (e.g. an approval is docked above the composer and the reader must
+ *   not lose it), appended messages and content growth do not move the viewport. The follow
+ *   intent is kept; JumpToLatest shows once held content has arrived (counting messages since the
+ *   hold began) and an explicit jump or a just-sent user message still scrolls. When the hold
+ *   ends and the reader has not scrolled away, the list returns to the bottom and follows again.
+ *   Mount and a conversation switch still start at the latest content.
+ *
+ * Motion: only messages that appear after mount (appended, not prepended history) play the
+ * AgentEntrance `message` entrance, once. No layout animation on the list. The jump uses a smooth
+ * scroll, `auto` under reduced motion.
+ */
+export type MessageListProps = Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> & {
+    messages: MessageView[];
+    /** Custom rendering per message; the list still wraps it in a keyed `<li data-message-id>`. */
+    renderMessage?: (message: MessageView, index: number) => React.ReactNode;
+    /** Props forwarded to the default AgentMessage (handlers, renderers). */
+    messageProps?: Omit<AgentMessageProps, 'message'>;
+    isStreaming?: boolean;
+    /** First load: no messages yet. */
+    loading?: boolean;
+    hasEarlier?: boolean;
+    onLoadEarlier?: () => void;
+    loadingEarlier?: boolean;
+    /** Error text for the last earlier-load attempt; shows a retry button. */
+    earlierError?: React.ReactNode;
+    /** Replaces the default empty state. */
+    empty?: React.ReactNode;
+    /** Content after the last message inside the scroller (run summary, typing line). */
+    footer?: React.ReactNode;
+    onFollowChange?: (following: boolean) => void;
+    /** Accessible name of the viewport. */
+    label?: string;
+    /** Turn off entrance motion for appended messages. */
+    animateEntrance?: boolean;
+    /** Pause auto-follow while true (content still renders); resumes on release if still at the latest. */
+    holdFollow?: boolean;
+};
+export declare const MessageList: React.ForwardRefExoticComponent<Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & {
+    messages: MessageView[];
+    /** Custom rendering per message; the list still wraps it in a keyed `<li data-message-id>`. */
+    renderMessage?: (message: MessageView, index: number) => React.ReactNode;
+    /** Props forwarded to the default AgentMessage (handlers, renderers). */
+    messageProps?: Omit<AgentMessageProps, "message">;
+    isStreaming?: boolean;
+    /** First load: no messages yet. */
+    loading?: boolean;
+    hasEarlier?: boolean;
+    onLoadEarlier?: () => void;
+    loadingEarlier?: boolean;
+    /** Error text for the last earlier-load attempt; shows a retry button. */
+    earlierError?: React.ReactNode;
+    /** Replaces the default empty state. */
+    empty?: React.ReactNode;
+    /** Content after the last message inside the scroller (run summary, typing line). */
+    footer?: React.ReactNode;
+    onFollowChange?: (following: boolean) => void;
+    /** Accessible name of the viewport. */
+    label?: string;
+    /** Turn off entrance motion for appended messages. */
+    animateEntrance?: boolean;
+    /** Pause auto-follow while true (content still renders); resumes on release if still at the latest. */
+    holdFollow?: boolean;
+} & React.RefAttributes<MessageListHandle>>;
+//# sourceMappingURL=MessageList.d.ts.map

package/dist/components/message/MessageList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageList.d.ts","sourceRoot":"","sources":["../../../src/components/message/MessageList.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,kGAAkG;AAClG,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IAChC,2FAA2F;IAC3F,cAAc,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IACzD,sDAAsD;IACtD,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,GAAG;IACtF,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,+FAA+F;IAC/F,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;IACzE,yEAAyE;IACzE,YAAY,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC/B,wCAAwC;IACxC,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,qFAAqF;IACrF,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9C,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,uGAAuG;IACvG,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAuBF,eAAO,MAAM,WAAW;cA/CZ,WAAW,EAAE;IACvB,+FAA+F;oBAC/E,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS;IACxE,yEAAyE;mBAC1D,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC;kBACnC,OAAO;IACrB,mCAAmC;cACzB,OAAO;iBACJ,OAAO;oBACJ,MAAM,IAAI;qBACT,OAAO;IACxB,0EAA0E;mBAC3D,KAAK,CAAC,SAAS;IAC9B,wCAAwC;YAChC,KAAK,CAAC,SAAS;IACvB,qFAAqF;aAC5E,KAAK,CAAC,SAAS;qBACP,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI;IAC7C,uCAAuC;YAC/B,MAAM;IACd,sDAAsD;sBACpC,OAAO;IACzB,uGAAuG;iBAC1F,OAAO;2CA4VpB,CAAC"}

package/dist/components/message/MessageList.js

@@ -0,0 +1,266 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from 'react';
+import { Button, EmptyState, Spinner, useRhineMotion } from '@wzrhine/react';
+import { AgentEntrance } from '../../motion/agent-motion.js';
+import { useAgentMessages } from '../../provider/AgentMessages.js';
+import { cx } from '../../utils/cx.js';
+import { AgentMessage } from './AgentMessage.js';
+import { JumpToLatest } from './JumpToLatest.js';
+/** Distance from the bottom (px, measured in JS) that still counts as "at the latest content". */
+export const FOLLOW_THRESHOLD_PX = 4;
+function itemNodes(viewport) {
+    return Array.from(viewport.querySelectorAll('li[data-message-id]'));
+}
+function distanceFromBottom(el) {
+    return el.scrollHeight - el.scrollTop - el.clientHeight;
+}
+/** First message whose box is (partly) below the viewport's top edge, with its offset from it. */
+function captureAnchor(viewport) {
+    const top = viewport.getBoundingClientRect().top;
+    const nodes = itemNodes(viewport);
+    const node = nodes.find((el) => el.getBoundingClientRect().bottom > top) ?? nodes[0];
+    const id = node?.dataset.messageId;
+    return node && id ? { id, offset: node.getBoundingClientRect().top - top } : null;
+}
+const UP_KEYS = new Set(['ArrowUp', 'PageUp', 'Home']);
+export const MessageList = React.forwardRef(function MessageList({ messages, renderMessage, messageProps, isStreaming = false, loading = false, hasEarlier = false, onLoadEarlier, loadingEarlier = false, earlierError, empty, footer, onFollowChange, label, animateEntrance = true, holdFollow = false, className, ...rest }, ref) {
+    const t = useAgentMessages().message;
+    const { reduced } = useRhineMotion();
+    const viewportRef = React.useRef(null);
+    const contentRef = React.useRef(null);
+    const followingRef = React.useRef(true);
+    const [following, setFollowingState] = React.useState(true);
+    const [leaveLastId, setLeaveLastId] = React.useState(null);
+    const lastTop = React.useRef(0);
+    const touchY = React.useRef(null);
+    const anchor = React.useRef(null);
+    const messagesRef = React.useRef(messages);
+    messagesRef.current = messages;
+    const holdRef = React.useRef(holdFollow);
+    holdRef.current = holdFollow;
+    /** Held content is waiting below the viewport; `holdBase` is the last id when the hold began. */
+    const [held, setHeld] = React.useState(false);
+    const holdBase = React.useRef(holdFollow ? (messages[messages.length - 1]?.id ?? null) : null);
+    const prevHold = React.useRef(holdFollow);
+    const mounted = React.useRef(false);
+    const setFollowing = React.useCallback((next) => {
+        if (followingRef.current === next)
+            return;
+        followingRef.current = next;
+        setFollowingState(next);
+        setLeaveLastId(next ? null : (messagesRef.current[messagesRef.current.length - 1]?.id ?? null));
+    }, []);
+    /** Programmatic scroll: remembered as the last position so the scroll event is not read as intent. */
+    const setTop = React.useCallback((value) => {
+        const el = viewportRef.current;
+        if (!el)
+            return;
+        el.scrollTop = value;
+        lastTop.current = el.scrollTop;
+    }, []);
+    const toBottom = React.useCallback(() => {
+        const el = viewportRef.current;
+        if (el)
+            setTop(el.scrollHeight);
+    }, [setTop]);
+    /** Follow-driven move to the bottom; suppressed (and remembered) while `holdFollow` is on. */
+    const followBottom = React.useCallback(() => {
+        const el = viewportRef.current;
+        if (!el)
+            return;
+        if (holdRef.current && mounted.current) {
+            if (distanceFromBottom(el) > FOLLOW_THRESHOLD_PX)
+                setHeld(true);
+            return;
+        }
+        toBottom();
+    }, [toBottom]);
+    const restoreAnchor = React.useCallback(() => {
+        const el = viewportRef.current;
+        const saved = anchor.current;
+        if (!el || !saved)
+            return false;
+        const node = itemNodes(el).find((n) => n.dataset.messageId === saved.id);
+        if (!node) {
+            anchor.current = null;
+            return false;
+        }
+        setTop(el.scrollTop + node.getBoundingClientRect().top - el.getBoundingClientRect().top - saved.offset);
+        return true;
+    }, [setTop]);
+    const scrollToLatest = React.useCallback((options) => {
+        const el = viewportRef.current;
+        anchor.current = null;
+        setFollowing(true);
+        setHeld(false);
+        if (!el)
+            return;
+        const smooth = (options?.smooth ?? true) && !reduced;
+        if (smooth && typeof el.scrollTo === 'function')
+            el.scrollTo({ top: el.scrollHeight, behavior: 'smooth' });
+        else
+            toBottom();
+    }, [reduced, setFollowing, toBottom]);
+    React.useImperativeHandle(ref, () => ({ scrollToLatest, isFollowing: () => followingRef.current, viewport: () => viewportRef.current }), [scrollToLatest]);
+    const releaseFollow = React.useCallback(() => {
+        const el = viewportRef.current;
+        if (!el || el.scrollHeight <= el.clientHeight)
+            return;
+        setFollowing(false);
+    }, [setFollowing]);
+    // Prepend detection: read the old DOM before React commits the new list (snapshot pattern).
+    const prevFirst = React.useRef(messages[0]?.id);
+    if (messages[0]?.id !== prevFirst.current && anchor.current === null && viewportRef.current && !followingRef.current) {
+        anchor.current = captureAnchor(viewportRef.current);
+    }
+    // Entrance only for messages appended after mount; prepended history and the first render stay still.
+    const known = React.useRef(null);
+    if (known.current === null)
+        known.current = new Set(messages.map((m) => m.id));
+    let lastKnownIndex = -1;
+    messages.forEach((m, i) => {
+        if (known.current.has(m.id))
+            lastKnownIndex = i;
+    });
+    // Nothing in common with what was shown before (conversation switch, snapshot reload): history.
+    const replaced = lastKnownIndex === -1 && known.current.size > 0;
+    const replacedRef = React.useRef(false);
+    replacedRef.current = replaced;
+    const prevLast = React.useRef(messages[messages.length - 1]?.id);
+    // Hold start: the base is the last message that was on screen before this render.
+    if (holdFollow && !prevHold.current)
+        holdBase.current = prevLast.current ?? null;
+    prevHold.current = holdFollow;
+    React.useLayoutEffect(() => {
+        const ids = known.current;
+        const reposition = !mounted.current || replacedRef.current;
+        if (replacedRef.current) {
+            // A different conversation: start at its latest content, following.
+            anchor.current = null;
+            setFollowing(true);
+            setHeld(false);
+        }
+        for (const m of messages)
+            ids.add(m.id);
+        prevFirst.current = messages[0]?.id;
+        const last = messages[messages.length - 1];
+        const sent = last !== undefined && last.id !== prevLast.current && last.role === 'user';
+        prevLast.current = last?.id;
+        if (restoreAnchor()) {
+            if (!loadingEarlier)
+                anchor.current = null;
+            return;
+        }
+        if (sent)
+            scrollToLatest({ smooth: false });
+        else if (reposition)
+            toBottom();
+        else if (followingRef.current)
+            followBottom();
+        mounted.current = true;
+    }, [messages, loadingEarlier, restoreAnchor, scrollToLatest, setFollowing, toBottom, followBottom]);
+    // Hold off: back to the bottom if the reader did not scroll away meanwhile.
+    React.useLayoutEffect(() => {
+        if (holdFollow)
+            return;
+        holdBase.current = null;
+        setHeld(false);
+        if (mounted.current && followingRef.current && !anchor.current)
+            toBottom();
+    }, [holdFollow, toBottom]);
+    // Content growth (streaming text, disclosures, images): keep the bottom or the anchor.
+    React.useEffect(() => {
+        const content = contentRef.current;
+        if (!content || typeof ResizeObserver === 'undefined')
+            return undefined;
+        const observer = new ResizeObserver(() => {
+            if (restoreAnchor())
+                return;
+            if (followingRef.current)
+                followBottom();
+        });
+        observer.observe(content);
+        return () => observer.disconnect();
+    }, [restoreAnchor, followBottom]);
+    const reportedFollow = React.useRef(following);
+    React.useEffect(() => {
+        if (reportedFollow.current === following)
+            return;
+        reportedFollow.current = following;
+        onFollowChange?.(following);
+    }, [following, onFollowChange]);
+    const handleScroll = () => {
+        const el = viewportRef.current;
+        if (!el)
+            return;
+        const top = el.scrollTop;
+        const distance = distanceFromBottom(el);
+        // Programmatic moves update `lastTop` first, so any other change is the reader's own scroll.
+        if (Math.abs(top - lastTop.current) > 1 && !loadingEarlier)
+            anchor.current = null;
+        if (top < lastTop.current - 1 && distance > FOLLOW_THRESHOLD_PX) {
+            // Moved up and not by us: scrollbar drag, keyboard, wheel, touch, find-in-page.
+            releaseFollow();
+        }
+        else if (distance <= FOLLOW_THRESHOLD_PX && !anchor.current) {
+            setFollowing(true);
+            setHeld(false);
+        }
+        lastTop.current = top;
+    };
+    const handleLoadEarlier = () => {
+        const el = viewportRef.current;
+        if (!onLoadEarlier || loadingEarlier)
+            return;
+        if (el)
+            anchor.current = captureAnchor(el);
+        setFollowing(false);
+        onLoadEarlier();
+    };
+    React.useEffect(() => {
+        if (earlierError)
+            anchor.current = null;
+    }, [earlierError]);
+    const atLatest = following && !held;
+    const unread = (() => {
+        const base = !following ? leaveLastId : held ? holdBase.current : null;
+        if (atLatest || base === null)
+            return 0;
+        const index = messages.findIndex((m) => m.id === base);
+        return index === -1 ? 0 : messages.length - 1 - index;
+    })();
+    const ownsEvent = (target) => target instanceof Node && viewportRef.current?.contains(target) === true;
+    const showEmpty = messages.length === 0 && !loading;
+    return (_jsxs("div", { ...rest, className: cx('rl-agent-list', className), "data-following": following || undefined, "data-hold": holdFollow || undefined, "data-streaming": isStreaming || undefined, children: [_jsx("section", { ref: viewportRef, className: "rl-agent-list__viewport", "aria-label": label ?? t.listLabel, "aria-busy": loading || loadingEarlier || undefined, tabIndex: 0, onScroll: handleScroll, onWheel: (event) => {
+                    if (!ownsEvent(event.target))
+                        return;
+                    anchor.current = null;
+                    if (event.deltaY < 0)
+                        releaseFollow();
+                }, onKeyDown: (event) => {
+                    if (event.target !== event.currentTarget)
+                        return;
+                    if (UP_KEYS.has(event.key) || (event.key === ' ' && event.shiftKey)) {
+                        anchor.current = null;
+                        releaseFollow();
+                    }
+                }, onTouchStart: (event) => {
+                    touchY.current = event.touches[0]?.clientY ?? null;
+                }, onTouchMove: (event) => {
+                    const y = event.touches[0]?.clientY;
+                    if (touchY.current !== null && y !== undefined) {
+                        if (y > touchY.current) {
+                            anchor.current = null;
+                            releaseFollow();
+                        }
+                        touchY.current = y;
+                    }
+                }, onTouchEnd: () => {
+                    touchY.current = null;
+                }, children: _jsxs("div", { ref: contentRef, className: "rl-agent-list__content", children: [hasEarlier && onLoadEarlier && (_jsx("div", { className: "rl-agent-list__earlier", children: earlierError ? (_jsxs("p", { className: "rl-agent-list__earlier-error", children: [_jsx("span", { children: earlierError === true ? t.earlierFailed : earlierError }), _jsx(Button, { size: "sm", variant: "secondary", onClick: handleLoadEarlier, children: t.retryEarlier })] })) : (_jsx(Button, { size: "sm", variant: "ghost", loading: loadingEarlier, onClick: handleLoadEarlier, children: loadingEarlier ? t.loadingEarlier : t.loadEarlier })) })), loading && messages.length === 0 && (_jsxs("div", { className: "rl-agent-list__loading", children: [_jsx(Spinner, { size: "sm", label: t.loading }), _jsx("span", { "aria-hidden": "true", children: t.loading })] })), showEmpty && _jsx("div", { className: "rl-agent-list__empty", children: empty ?? _jsx(EmptyState, { size: "sm", title: t.empty, description: t.emptyDescription }) }), messages.length > 0 && (_jsx("ol", { className: "rl-agent-list__items", children: messages.map((message, index) => {
+                                const appended = !replaced && !known.current.has(message.id) && index > lastKnownIndex;
+                                return (_jsx(AgentEntrance, { as: "li", kind: "message", animate: animateEntrance && appended, className: "rl-agent-list__item", "data-message-id": message.id, "data-role": message.role, children: renderMessage ? renderMessage(message, index) : _jsx(AgentMessage, { ...messageProps, message: message }) }, message.id));
+                            }) })), footer != null && _jsx("div", { className: "rl-agent-list__footer", children: footer })] }) }), _jsx("div", { className: "rl-agent-list__jump", children: _jsx(JumpToLatest, { atLatest: atLatest, unreadCount: unread, onJump: () => scrollToLatest() }) })] }));
+});
+//# sourceMappingURL=MessageList.js.map

package/dist/components/message/MessageList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageList.js","sourceRoot":"","sources":["../../../src/components/message/MessageList.tsx"],"names":[],"mappings":"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"}

package/dist/components/message/MessagePart.d.ts

@@ -0,0 +1,44 @@
+import * as React from 'react';
+import type { ArtifactView, CitationView, MessagePartView, RecoveryView, ToolCallView } from '@wzrhine/agent-core';
+import type { ArtifactRenderer, MessagePartRenderers, ToolRenderer } from './renderers.js';
+import type { CopyHandler } from './use-copy.js';
+/**
+ * MessagePart (atlas 06): renders one `MessagePartView` by `type`. Stable by `part.id` (the
+ * caller keys it). Every branch keeps real text in the DOM; nothing is ever rendered blank:
+ * a `custom` part without a registered renderer, or a part type this version does not know,
+ * shows a fallback box with the type / renderer name, the summary and "无法显示此内容".
+ *
+ * Tool calls and artifacts belong to other families: pass `renderTool` / `renderArtifact` to
+ * plug the real components in; the built-in fallback is one line (name + status / title + status).
+ */
+export interface MessagePartProps {
+    part: MessagePartView;
+    renderers?: MessagePartRenderers;
+    renderTool?: ToolRenderer;
+    renderArtifact?: ArtifactRenderer;
+    onOpenCitation?: (citation: CitationView) => void;
+    /** Error part actions: `(errorId, actionId)`. Without it the action buttons are not rendered. */
+    onRecoveryAction?: (errorId: string, actionId: string) => void;
+    onOpenThinking?: (thinkingId: string) => void;
+    onCopy?: CopyHandler;
+}
+export declare function ToolFallback({ tool }: {
+    tool: ToolCallView;
+}): React.JSX.Element;
+export declare function ArtifactFallback({ artifact }: {
+    artifact: ArtifactView;
+}): React.JSX.Element;
+/** Error part: a static callout-style notice (not a live region; the message status announces). */
+export declare function MessageErrorNotice({ error, onAction }: {
+    error: RecoveryView;
+    onAction?: (errorId: string, actionId: string) => void;
+}): React.JSX.Element;
+/** Fallback for unregistered custom renderers and unknown part types. Never blank. */
+export declare function UnsupportedPart({ type, summary }: {
+    type: string;
+    summary?: string;
+}): React.JSX.Element;
+/** Parts that flow inline with text (chips) rather than taking their own block. */
+export declare const INLINE_PART_TYPES: ReadonlySet<string>;
+export declare function MessagePart({ part, renderers, renderTool, renderArtifact, onOpenCitation, onRecoveryAction, onOpenThinking, onCopy }: MessagePartProps): React.JSX.Element;
+//# sourceMappingURL=MessagePart.d.ts.map

package/dist/components/message/MessagePart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessagePart.d.ts","sourceRoot":"","sources":["../../../src/components/message/MessagePart.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,YAAY,EAAkB,YAAY,EAAE,eAAe,EAAE,YAAY,EAAiB,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAWlJ,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAClC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IAClD,iGAAiG;IACjG,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,cAAc,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AA8BD,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,qBAU5D;AAED,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,YAAY,CAAA;CAAE,qBAWxE;AAmDD,mGAAmG;AACnG,wBAAgB,kBAAkB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,qBAqCtI;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,qBAYpF;AAgBD,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAoD,CAAC;AAEvG,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,gBAAgB,qBA8DtJ"}