@djangocfg/ui-tools 2.1.368 → 2.1.371

package/dist/index.d.cts

@@ -1568,6 +1568,12 @@ interface SessionInfo {
     hasMore?: boolean;
     cursor?: string | null;
     resumed?: boolean;
+    /**
+     * Optional human-readable title (typically derived from the first
+     * user message). Hosts that render a session-list sidebar can read
+     * this directly instead of crawling messages. Plan64.
+     */
+    title?: string;
 }
 interface HistoryPage {
     messages: ChatMessage[];
@@ -1798,6 +1804,16 @@ interface UseChatConfig {
     metadata?: Record<string, unknown>;
     /** Stamped on outgoing user messages as `message.sender`. */
     userPersona?: ChatPersona;
+    /**
+     * Rewrite the outgoing message content right before it hits the
+     * transport — runs after the user bubble is added (so history shows
+     * the original) but before `transport.stream/send`. Sync or async.
+     * Return the original to opt out for that call.
+     *
+     * Use case: strip rich-display chips (e.g. mention links) so the LLM
+     * sees plain text, while the bubble keeps the chip rendering. Plan64.
+     */
+    onBeforeSend?: (content: string) => string | Promise<string>;
     /**
      * Enable verbose dev-mode logging (consola, namespace `chat:*`).
      * Defaults to `isDev` from `@djangocfg/ui-core/lib`. Pass `false` to silence
@@ -1863,9 +1879,15 @@ interface ChatProviderProps {
     audio?: ChatAudioConfig;
     /** Enable verbose dev logging via consola. Defaults to `isDev`. */
     debug?: boolean;
+    /**
+     * Rewrite outgoing message content before it hits the transport.
+     * History bubble keeps the original; useful for stripping rich-
+     * display chips so the LLM sees plain text. See `useChat`.
+     */
+    onBeforeSend?: (content: string) => string | Promise<string>;
     children?: ReactNode;
 }
-declare function ChatProvider({ transport, config, initialSessionId, autoCreateSession, streaming, audio, debug, children, }: ChatProviderProps): react_jsx_runtime.JSX.Element;
+declare function ChatProvider({ transport, config, initialSessionId, autoCreateSession, streaming, audio, debug, onBeforeSend, children, }: ChatProviderProps): react_jsx_runtime.JSX.Element;
 declare function useChatContext(): ChatContextValue;
 declare function useChatContextOptional(): ChatContextValue | null;
 
@@ -1882,6 +1904,16 @@ interface UseChatComposerOptions {
         size?: number;
     };
     onPasteFiles?: (files: File[]) => void;
+    /**
+     * Persist the current draft to `sessionStorage` under this key. The
+     * draft is loaded once on mount (overrides `initialValue` if non-
+     * empty) and rewritten on every value change. Cleared on `reset()`.
+     *
+     * Pass a per-conversation id to keep separate drafts per chat. Pass
+     * `undefined` (default) to disable persistence — composer behaves
+     * exactly as before. Plan64.
+     */
+    persistKey?: string;
 }
 interface UseChatComposerReturn {
     value: string;
@@ -2204,6 +2236,19 @@ declare class TransportError extends Error {
     constructor(message: string, code?: string);
 }
 
+/**
+ * @deprecated Plan64. As of ui-tools 2.1.369, `<MessageList>` is
+ * virtualized via react-virtuoso and owns its own scroll viewport.
+ * Sticky-bottom + auto-follow on streaming live inside the component;
+ * use the new `MessageListProps.onAtBottomChange` prop and the
+ * `MessageListHandle.scrollToBottom()` imperative method instead.
+ *
+ * This hook is kept for hosts that render messages outside
+ * `<MessageList>` (e.g. headless story shells, custom non-virtualized
+ * scroll containers). It still works against any HTMLElement scroll
+ * container, but it does NOT integrate with Virtuoso — passing a
+ * Virtuoso-managed element here will read garbage scroll metrics.
+ */
 interface UseChatScrollOptions {
     containerRef: RefObject<HTMLElement | null>;
     bottomRef: RefObject<HTMLElement | null>;
@@ -2338,12 +2383,55 @@ interface MessageListProps {
     renderItem?: (m: ChatMessage, i: number) => ReactNode;
     renderEmpty?: () => ReactNode;
     isLoadingMore?: boolean;
+    /**
+     * Fires when the user scrolls within `topThresholdPx` of the top of
+     * the list — wire to your `loadMore()` here. Replaces the previous
+     * `topSentinelRef` API. The callback is gated by Virtuoso, so it
+     * won't fire repeatedly while a load is in flight (Virtuoso pauses
+     * `startReached` until `data` length grows).
+     */
+    onStartReached?: () => void;
+    /**
+     * @deprecated Kept as a no-op for backwards compatibility — wire
+     * `onStartReached` instead. Virtuoso owns the scroll viewport now,
+     * external sentinels never see scroll events.
+     */
     topSentinelRef?: RefObject<HTMLDivElement | null>;
+    /**
+     * @deprecated Kept as a no-op for backwards compatibility — Virtuoso
+     * exposes `scrollToIndex` via the imperative handle instead. See
+     * `useChatScroll` for the chat-friendly wrapper.
+     */
     bottomRef?: RefObject<HTMLDivElement | null>;
     className?: string;
     itemClassName?: string;
+    /**
+     * Skip virtualization and render through plain `.map()`. Use for
+     * stories / debugging where DevTools needs to see every node, or
+     * when `messages` is guaranteed-tiny. Default: `false` — virtualize
+     * always. Plan64.
+     */
+    noVirtualize?: boolean;
+    /**
+     * Initial item height estimate fed to Virtuoso's first-paint pass.
+     * The library re-measures every item after mount; this just tightens
+     * the initial scrollbar before measurements land. Default `120`.
+     */
+    defaultItemHeight?: number;
+    /**
+     * Fires when the viewport sticky state changes — `true` when the
+     * user is pinned to the bottom (streaming token deltas keep them
+     * there), `false` once they scroll up. Wire to your "Jump to
+     * latest" affordance via the inverse: render the pill when
+     * `!isAtBottom`. Plan64.
+     */
+    onAtBottomChange?: (isAtBottom: boolean) => void;
+}
+interface MessageListHandle {
+    scrollToBottom: (smooth?: boolean) => void;
+    scrollToIndex: (index: number, smooth?: boolean) => void;
 }
-declare const MessageList: react.ForwardRefExoticComponent<MessageListProps & react.RefAttributes<HTMLDivElement>>;
+declare const MessageList: react.ForwardRefExoticComponent<MessageListProps & react.RefAttributes<MessageListHandle>>;
 
 interface MessageBubbleProps {
     message: ChatMessage;
@@ -2375,8 +2463,29 @@ interface MessageBubbleProps {
     onRegenerate?: () => void;
     onEdit?: () => void;
     onDelete?: () => void;
+    /**
+     * Extra content rendered alongside the default copy/regenerate/edit/
+     * delete actions (after them, on the same row). Hosts pass app-
+     * specific affordances here — e.g. "Send to plan", "Add note",
+     * "Open in inspector" — without having to fork `<MessageActions>`.
+     * Receives the message so renderers can branch by id / role / etc.
+     * Plan64.
+     */
+    messageActionsExtra?: (m: ChatMessage) => ReactNode;
+    /**
+     * Override the default streaming indicator (the dots / pulse + tool
+     * activity label). Receives the message so the host can read
+     * `toolActivity`, the running tool call name, etc., and render a
+     * richer affordance ("Running cmd_execute on vps-audi…"). Plan64.
+     *
+     * Renders in two slots: as the in-bubble pre-token affordance, and
+     * as the inline label above the bubble when `toolActivity` is set.
+     * The render-prop is called for both — branch on `m.content` if
+     * you need different behaviour per slot.
+     */
+    streamingIndicator?: (m: ChatMessage) => ReactNode;
 }
-declare const MessageBubble: react.MemoExoticComponent<({ message, isUser: isUserProp, showAvatar, avatarSrc, avatarFallback, user, assistant, showTimestamp, showActions, isCompact, className, beforeContent, afterContent, toolCallsRenderer, toolCallsProps, sourcesRenderer, attachmentsRenderer, attachmentRenderers, onAttachmentOpen, onCopy, onRegenerate, onEdit, onDelete, }: MessageBubbleProps) => react_jsx_runtime.JSX.Element>;
+declare const MessageBubble: react.MemoExoticComponent<({ message, isUser: isUserProp, showAvatar, avatarSrc, avatarFallback, user, assistant, showTimestamp, showActions, isCompact, className, beforeContent, afterContent, toolCallsRenderer, toolCallsProps, sourcesRenderer, attachmentsRenderer, attachmentRenderers, onAttachmentOpen, onCopy, onRegenerate, onEdit, onDelete, messageActionsExtra, streamingIndicator, }: MessageBubbleProps) => react_jsx_runtime.JSX.Element>;
 
 interface MessageActionsProps {
     role: ChatRole;
@@ -3479,4 +3588,4 @@ declare function useBlobUrlCleanup(key: string | null): void;
  */
 declare function generateContentKey(content: ArrayBuffer): string;
 
-export { type ApiKey, ArrayFieldItemTemplate, ArrayFieldTemplate, type AspectRatioValue, type AttachmentRenderer, type AttachmentRendererArgs, type AttachmentRendererMap, Attachments, AttachmentsGrid, type AttachmentsGridProps, AttachmentsList, type AttachmentsListProps, type AttachmentsProps, Player as AudioPlayer, type PlayerProps as AudioPlayerProps, AudioToggle, type AudioToggleProps, BaseInputTemplate, type BlobSource, CHAT_EVENT_NAME, CSS_VARS, CardLoadingFallback, type ChatAction, type ChatAssistantContext, type ChatAttachment, type ChatAudioConfig, type ChatAudioEvent, type ChatAudioSounds, type ChatConfig, type ChatContextValue, type ChatDisplayMode, type ChatEventDetail, type ChatLabels, type ChatLightboxState, type ChatLogScope, type ChatLogger, type ChatMessage, type ChatPersona, type ChatPrefs, ChatProvider, type ChatProviderProps, type ChatRole, ChatRoot, type ChatRootProps, type ChatSource, type ChatState, type ChatStreamEvent, type ChatToolCall, type ChatTransport, type ChatUserContext, CheckboxWidget, ColorWidget, Composer, type ComposerProps, type CreateLazyComponentOptions, type CreateSessionOptions, type CreateVideoErrorFallbackOptions, CronScheduler, type CronSchedulerContextValue, type CronSchedulerProps, CronSchedulerProvider, type CronSchedulerState, CustomInput, type DASHSource, DEFAULT_LABELS, DEFAULT_SIDEBAR, DEFAULT_Z_INDEX, type DataUrlSource, DayChips, DiffEditor, type DiffEditorProps, type DisabledWhenRule, Editor, type EditorContextValue, type EditorFile, type EditorOptions, type EditorProps, EditorProvider, type EditorRef, EmptyState, type EmptyStateProps, ErrorBanner, type ErrorBannerProps, type ErrorFallbackProps, ErrorListTemplate, FieldTemplate, type HLSSource, HOTKEYS, type HistoryPage, type HttpTransportConfig, type ImageFile, ImageViewer, type ImageViewerProps, type JsonFormContext, type JsonFormDensity, JsonSchemaForm, type JsonSchemaFormProps, JsonTreeComponent as JsonTree, type JsonTreeConfig, type JsonTreeProps, JumpToLatest, type JumpToLatestProps, LIMITS, LazyPlayer as LazyAudioPlayer, LazyChat, type ChatRootProps as LazyChatProps, LazyCronScheduler, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyTree, TreeRootProps as LazyTreeProps, LazyVideoPlayer, LazyWrapper, type LazyWrapperProps, type LinkRule, LoadingFallback, type LoadingFallbackProps, type LottieDirection, LottiePlayer, type LottiePlayerProps, type LottieSize, type LottieSpeed, type MapContainerProps, MapLoadingFallback, type MapStyleKey, type MapViewport, MarkdownEditor, type MarkdownEditorProps, MarkdownMessage, type MarkdownMessageProps, type MarkerData, type MentionAttrs, type MentionConfig, type MentionItem, type MentionMarkdownRenderer, Mermaid, type MermaidProps, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, MessageList, type MessageListProps, type MockTransportOptions, type MonthDay, MonthDayGrid, NativeProvider, NumberWidget, ObjectFieldTemplate, Playground as OpenapiViewer, type ParseSSEOptions, type PlayerMode, type PlaygroundConfig, type PlaygroundProps$1 as PlaygroundProps, PrettyCode, type PrettyCodeProps$1 as PrettyCodeProps, type ResolveFileSourceOptions, STORAGE_KEYS, SchedulePreview, type ScheduleType, ScheduleTypeSelector, type SchemaSource, SelectWidget, type SendOptions, type SessionInfo, type SimpleStreamSource, SliderWidget, Sources, type SourcesProps, Spinner, type StreamOptions, StreamProvider, type StreamSource, StreamingIndicator, type StreamingIndicatorProps, SwitchWidget, TextWidget, TimeSelector, type TokenBuffer, ToolCalls, type ToolCallsProps, type ToolPayloadFallback, type ToolPayloadKind, type ToolPayloadMatcher, TransportError, TreeRootProps, type UiGroup, type UrlSource, type UseChatAudioReturn, type UseChatComposerOptions, type UseChatComposerReturn, type UseChatConfig, type UseChatHistoryOptions, type UseChatLayoutConfig, type UseChatLayoutReturn, type UseChatLightboxReturn, type UseChatReturn, type UseChatScrollOptions, type UseChatScrollReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseEditorReturn, type UseLottieOptions, type UseLottieReturn, type UseMonacoReturn, VideoControls, VideoErrorFallback, type VideoErrorFallbackProps, VideoPlayer, type VideoPlayerContextValue, type VideoPlayerProps, VideoPlayerProvider, type VideoPlayerProviderProps, type VideoPlayerRef, type VideoSourceUnion, VidstackProvider, type VimeoSource, type WeekDay, type YouTubeSource, buildCron, collectImageAttachments, createHttpTransport, createId, createLazyComponent, createMockTransport, createTokenBuffer, createVideoErrorFallback, deriveInitials, dispatchToolPayload, evaluateDisabledWhen, extractTextFromChildren, generateContentKey, getChatLogger, getRequiredFields, hasRequiredFields, humanizeCron, initialState, isGeoJSONFeatureCollection, isLatLng, isPlainObject, isSimpleStreamSource, isStringValue, isValidCron, mentionPresets, mergeDefaults, normalizeFormData, parseCron, parseSSE, reducer, resolveFileSource, resolvePersona, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, useAudioCache, useBlobUrlCleanup, useChat, useChatAudio, useChatAudioPrefs, useChatComposer, useChatContext, useChatContextOptional, useChatHistory, useChatLayout, useChatLightbox, useChatScroll, useCollapsibleContent, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays, useEditor, useEditorContext, useImageCache, useLanguage, useLottie, useMediaCacheStore, useMonaco, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, validateRequiredFields, validateSchema };
+export { type ApiKey, ArrayFieldItemTemplate, ArrayFieldTemplate, type AspectRatioValue, type AttachmentRenderer, type AttachmentRendererArgs, type AttachmentRendererMap, Attachments, AttachmentsGrid, type AttachmentsGridProps, AttachmentsList, type AttachmentsListProps, type AttachmentsProps, Player as AudioPlayer, type PlayerProps as AudioPlayerProps, AudioToggle, type AudioToggleProps, BaseInputTemplate, type BlobSource, CHAT_EVENT_NAME, CSS_VARS, CardLoadingFallback, type ChatAction, type ChatAssistantContext, type ChatAttachment, type ChatAudioConfig, type ChatAudioEvent, type ChatAudioSounds, type ChatConfig, type ChatContextValue, type ChatDisplayMode, type ChatEventDetail, type ChatLabels, type ChatLightboxState, type ChatLogScope, type ChatLogger, type ChatMessage, type ChatPersona, type ChatPrefs, ChatProvider, type ChatProviderProps, type ChatRole, ChatRoot, type ChatRootProps, type ChatSource, type ChatState, type ChatStreamEvent, type ChatToolCall, type ChatTransport, type ChatUserContext, CheckboxWidget, ColorWidget, Composer, type ComposerProps, type CreateLazyComponentOptions, type CreateSessionOptions, type CreateVideoErrorFallbackOptions, CronScheduler, type CronSchedulerContextValue, type CronSchedulerProps, CronSchedulerProvider, type CronSchedulerState, CustomInput, type DASHSource, DEFAULT_LABELS, DEFAULT_SIDEBAR, DEFAULT_Z_INDEX, type DataUrlSource, DayChips, DiffEditor, type DiffEditorProps, type DisabledWhenRule, Editor, type EditorContextValue, type EditorFile, type EditorOptions, type EditorProps, EditorProvider, type EditorRef, EmptyState, type EmptyStateProps, ErrorBanner, type ErrorBannerProps, type ErrorFallbackProps, ErrorListTemplate, FieldTemplate, type HLSSource, HOTKEYS, type HistoryPage, type HttpTransportConfig, type ImageFile, ImageViewer, type ImageViewerProps, type JsonFormContext, type JsonFormDensity, JsonSchemaForm, type JsonSchemaFormProps, JsonTreeComponent as JsonTree, type JsonTreeConfig, type JsonTreeProps, JumpToLatest, type JumpToLatestProps, LIMITS, LazyPlayer as LazyAudioPlayer, LazyChat, type ChatRootProps as LazyChatProps, LazyCronScheduler, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyTree, TreeRootProps as LazyTreeProps, LazyVideoPlayer, LazyWrapper, type LazyWrapperProps, type LinkRule, LoadingFallback, type LoadingFallbackProps, type LottieDirection, LottiePlayer, type LottiePlayerProps, type LottieSize, type LottieSpeed, type MapContainerProps, MapLoadingFallback, type MapStyleKey, type MapViewport, MarkdownEditor, type MarkdownEditorProps, MarkdownMessage, type MarkdownMessageProps, type MarkerData, type MentionAttrs, type MentionConfig, type MentionItem, type MentionMarkdownRenderer, Mermaid, type MermaidProps, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, MessageList, type MessageListHandle, type MessageListProps, type MockTransportOptions, type MonthDay, MonthDayGrid, NativeProvider, NumberWidget, ObjectFieldTemplate, Playground as OpenapiViewer, type ParseSSEOptions, type PlayerMode, type PlaygroundConfig, type PlaygroundProps$1 as PlaygroundProps, PrettyCode, type PrettyCodeProps$1 as PrettyCodeProps, type ResolveFileSourceOptions, STORAGE_KEYS, SchedulePreview, type ScheduleType, ScheduleTypeSelector, type SchemaSource, SelectWidget, type SendOptions, type SessionInfo, type SimpleStreamSource, SliderWidget, Sources, type SourcesProps, Spinner, type StreamOptions, StreamProvider, type StreamSource, StreamingIndicator, type StreamingIndicatorProps, SwitchWidget, TextWidget, TimeSelector, type TokenBuffer, ToolCalls, type ToolCallsProps, type ToolPayloadFallback, type ToolPayloadKind, type ToolPayloadMatcher, TransportError, TreeRootProps, type UiGroup, type UrlSource, type UseChatAudioReturn, type UseChatComposerOptions, type UseChatComposerReturn, type UseChatConfig, type UseChatHistoryOptions, type UseChatLayoutConfig, type UseChatLayoutReturn, type UseChatLightboxReturn, type UseChatReturn, type UseChatScrollOptions, type UseChatScrollReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseEditorReturn, type UseLottieOptions, type UseLottieReturn, type UseMonacoReturn, VideoControls, VideoErrorFallback, type VideoErrorFallbackProps, VideoPlayer, type VideoPlayerContextValue, type VideoPlayerProps, VideoPlayerProvider, type VideoPlayerProviderProps, type VideoPlayerRef, type VideoSourceUnion, VidstackProvider, type VimeoSource, type WeekDay, type YouTubeSource, buildCron, collectImageAttachments, createHttpTransport, createId, createLazyComponent, createMockTransport, createTokenBuffer, createVideoErrorFallback, deriveInitials, dispatchToolPayload, evaluateDisabledWhen, extractTextFromChildren, generateContentKey, getChatLogger, getRequiredFields, hasRequiredFields, humanizeCron, initialState, isGeoJSONFeatureCollection, isLatLng, isPlainObject, isSimpleStreamSource, isStringValue, isValidCron, mentionPresets, mergeDefaults, normalizeFormData, parseCron, parseSSE, reducer, resolveFileSource, resolvePersona, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, useAudioCache, useBlobUrlCleanup, useChat, useChatAudio, useChatAudioPrefs, useChatComposer, useChatContext, useChatContextOptional, useChatHistory, useChatLayout, useChatLightbox, useChatScroll, useCollapsibleContent, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays, useEditor, useEditorContext, useImageCache, useLanguage, useLottie, useMediaCacheStore, useMonaco, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, validateRequiredFields, validateSchema };

package/dist/index.d.ts

@@ -1568,6 +1568,12 @@ interface SessionInfo {
     hasMore?: boolean;
     cursor?: string | null;
     resumed?: boolean;
+    /**
+     * Optional human-readable title (typically derived from the first
+     * user message). Hosts that render a session-list sidebar can read
+     * this directly instead of crawling messages. Plan64.
+     */
+    title?: string;
 }
 interface HistoryPage {
     messages: ChatMessage[];
@@ -1798,6 +1804,16 @@ interface UseChatConfig {
     metadata?: Record<string, unknown>;
     /** Stamped on outgoing user messages as `message.sender`. */
     userPersona?: ChatPersona;
+    /**
+     * Rewrite the outgoing message content right before it hits the
+     * transport — runs after the user bubble is added (so history shows
+     * the original) but before `transport.stream/send`. Sync or async.
+     * Return the original to opt out for that call.
+     *
+     * Use case: strip rich-display chips (e.g. mention links) so the LLM
+     * sees plain text, while the bubble keeps the chip rendering. Plan64.
+     */
+    onBeforeSend?: (content: string) => string | Promise<string>;
     /**
      * Enable verbose dev-mode logging (consola, namespace `chat:*`).
      * Defaults to `isDev` from `@djangocfg/ui-core/lib`. Pass `false` to silence
@@ -1863,9 +1879,15 @@ interface ChatProviderProps {
     audio?: ChatAudioConfig;
     /** Enable verbose dev logging via consola. Defaults to `isDev`. */
     debug?: boolean;
+    /**
+     * Rewrite outgoing message content before it hits the transport.
+     * History bubble keeps the original; useful for stripping rich-
+     * display chips so the LLM sees plain text. See `useChat`.
+     */
+    onBeforeSend?: (content: string) => string | Promise<string>;
     children?: ReactNode;
 }
-declare function ChatProvider({ transport, config, initialSessionId, autoCreateSession, streaming, audio, debug, children, }: ChatProviderProps): react_jsx_runtime.JSX.Element;
+declare function ChatProvider({ transport, config, initialSessionId, autoCreateSession, streaming, audio, debug, onBeforeSend, children, }: ChatProviderProps): react_jsx_runtime.JSX.Element;
 declare function useChatContext(): ChatContextValue;
 declare function useChatContextOptional(): ChatContextValue | null;
 
@@ -1882,6 +1904,16 @@ interface UseChatComposerOptions {
         size?: number;
     };
     onPasteFiles?: (files: File[]) => void;
+    /**
+     * Persist the current draft to `sessionStorage` under this key. The
+     * draft is loaded once on mount (overrides `initialValue` if non-
+     * empty) and rewritten on every value change. Cleared on `reset()`.
+     *
+     * Pass a per-conversation id to keep separate drafts per chat. Pass
+     * `undefined` (default) to disable persistence — composer behaves
+     * exactly as before. Plan64.
+     */
+    persistKey?: string;
 }
 interface UseChatComposerReturn {
     value: string;
@@ -2204,6 +2236,19 @@ declare class TransportError extends Error {
     constructor(message: string, code?: string);
 }
 
+/**
+ * @deprecated Plan64. As of ui-tools 2.1.369, `<MessageList>` is
+ * virtualized via react-virtuoso and owns its own scroll viewport.
+ * Sticky-bottom + auto-follow on streaming live inside the component;
+ * use the new `MessageListProps.onAtBottomChange` prop and the
+ * `MessageListHandle.scrollToBottom()` imperative method instead.
+ *
+ * This hook is kept for hosts that render messages outside
+ * `<MessageList>` (e.g. headless story shells, custom non-virtualized
+ * scroll containers). It still works against any HTMLElement scroll
+ * container, but it does NOT integrate with Virtuoso — passing a
+ * Virtuoso-managed element here will read garbage scroll metrics.
+ */
 interface UseChatScrollOptions {
     containerRef: RefObject<HTMLElement | null>;
     bottomRef: RefObject<HTMLElement | null>;
@@ -2338,12 +2383,55 @@ interface MessageListProps {
     renderItem?: (m: ChatMessage, i: number) => ReactNode;
     renderEmpty?: () => ReactNode;
     isLoadingMore?: boolean;
+    /**
+     * Fires when the user scrolls within `topThresholdPx` of the top of
+     * the list — wire to your `loadMore()` here. Replaces the previous
+     * `topSentinelRef` API. The callback is gated by Virtuoso, so it
+     * won't fire repeatedly while a load is in flight (Virtuoso pauses
+     * `startReached` until `data` length grows).
+     */
+    onStartReached?: () => void;
+    /**
+     * @deprecated Kept as a no-op for backwards compatibility — wire
+     * `onStartReached` instead. Virtuoso owns the scroll viewport now,
+     * external sentinels never see scroll events.
+     */
     topSentinelRef?: RefObject<HTMLDivElement | null>;
+    /**
+     * @deprecated Kept as a no-op for backwards compatibility — Virtuoso
+     * exposes `scrollToIndex` via the imperative handle instead. See
+     * `useChatScroll` for the chat-friendly wrapper.
+     */
     bottomRef?: RefObject<HTMLDivElement | null>;
     className?: string;
     itemClassName?: string;
+    /**
+     * Skip virtualization and render through plain `.map()`. Use for
+     * stories / debugging where DevTools needs to see every node, or
+     * when `messages` is guaranteed-tiny. Default: `false` — virtualize
+     * always. Plan64.
+     */
+    noVirtualize?: boolean;
+    /**
+     * Initial item height estimate fed to Virtuoso's first-paint pass.
+     * The library re-measures every item after mount; this just tightens
+     * the initial scrollbar before measurements land. Default `120`.
+     */
+    defaultItemHeight?: number;
+    /**
+     * Fires when the viewport sticky state changes — `true` when the
+     * user is pinned to the bottom (streaming token deltas keep them
+     * there), `false` once they scroll up. Wire to your "Jump to
+     * latest" affordance via the inverse: render the pill when
+     * `!isAtBottom`. Plan64.
+     */
+    onAtBottomChange?: (isAtBottom: boolean) => void;
+}
+interface MessageListHandle {
+    scrollToBottom: (smooth?: boolean) => void;
+    scrollToIndex: (index: number, smooth?: boolean) => void;
 }
-declare const MessageList: react.ForwardRefExoticComponent<MessageListProps & react.RefAttributes<HTMLDivElement>>;
+declare const MessageList: react.ForwardRefExoticComponent<MessageListProps & react.RefAttributes<MessageListHandle>>;
 
 interface MessageBubbleProps {
     message: ChatMessage;
@@ -2375,8 +2463,29 @@ interface MessageBubbleProps {
     onRegenerate?: () => void;
     onEdit?: () => void;
     onDelete?: () => void;
+    /**
+     * Extra content rendered alongside the default copy/regenerate/edit/
+     * delete actions (after them, on the same row). Hosts pass app-
+     * specific affordances here — e.g. "Send to plan", "Add note",
+     * "Open in inspector" — without having to fork `<MessageActions>`.
+     * Receives the message so renderers can branch by id / role / etc.
+     * Plan64.
+     */
+    messageActionsExtra?: (m: ChatMessage) => ReactNode;
+    /**
+     * Override the default streaming indicator (the dots / pulse + tool
+     * activity label). Receives the message so the host can read
+     * `toolActivity`, the running tool call name, etc., and render a
+     * richer affordance ("Running cmd_execute on vps-audi…"). Plan64.
+     *
+     * Renders in two slots: as the in-bubble pre-token affordance, and
+     * as the inline label above the bubble when `toolActivity` is set.
+     * The render-prop is called for both — branch on `m.content` if
+     * you need different behaviour per slot.
+     */
+    streamingIndicator?: (m: ChatMessage) => ReactNode;
 }
-declare const MessageBubble: react.MemoExoticComponent<({ message, isUser: isUserProp, showAvatar, avatarSrc, avatarFallback, user, assistant, showTimestamp, showActions, isCompact, className, beforeContent, afterContent, toolCallsRenderer, toolCallsProps, sourcesRenderer, attachmentsRenderer, attachmentRenderers, onAttachmentOpen, onCopy, onRegenerate, onEdit, onDelete, }: MessageBubbleProps) => react_jsx_runtime.JSX.Element>;
+declare const MessageBubble: react.MemoExoticComponent<({ message, isUser: isUserProp, showAvatar, avatarSrc, avatarFallback, user, assistant, showTimestamp, showActions, isCompact, className, beforeContent, afterContent, toolCallsRenderer, toolCallsProps, sourcesRenderer, attachmentsRenderer, attachmentRenderers, onAttachmentOpen, onCopy, onRegenerate, onEdit, onDelete, messageActionsExtra, streamingIndicator, }: MessageBubbleProps) => react_jsx_runtime.JSX.Element>;
 
 interface MessageActionsProps {
     role: ChatRole;
@@ -3479,4 +3588,4 @@ declare function useBlobUrlCleanup(key: string | null): void;
  */
 declare function generateContentKey(content: ArrayBuffer): string;
 
-export { type ApiKey, ArrayFieldItemTemplate, ArrayFieldTemplate, type AspectRatioValue, type AttachmentRenderer, type AttachmentRendererArgs, type AttachmentRendererMap, Attachments, AttachmentsGrid, type AttachmentsGridProps, AttachmentsList, type AttachmentsListProps, type AttachmentsProps, Player as AudioPlayer, type PlayerProps as AudioPlayerProps, AudioToggle, type AudioToggleProps, BaseInputTemplate, type BlobSource, CHAT_EVENT_NAME, CSS_VARS, CardLoadingFallback, type ChatAction, type ChatAssistantContext, type ChatAttachment, type ChatAudioConfig, type ChatAudioEvent, type ChatAudioSounds, type ChatConfig, type ChatContextValue, type ChatDisplayMode, type ChatEventDetail, type ChatLabels, type ChatLightboxState, type ChatLogScope, type ChatLogger, type ChatMessage, type ChatPersona, type ChatPrefs, ChatProvider, type ChatProviderProps, type ChatRole, ChatRoot, type ChatRootProps, type ChatSource, type ChatState, type ChatStreamEvent, type ChatToolCall, type ChatTransport, type ChatUserContext, CheckboxWidget, ColorWidget, Composer, type ComposerProps, type CreateLazyComponentOptions, type CreateSessionOptions, type CreateVideoErrorFallbackOptions, CronScheduler, type CronSchedulerContextValue, type CronSchedulerProps, CronSchedulerProvider, type CronSchedulerState, CustomInput, type DASHSource, DEFAULT_LABELS, DEFAULT_SIDEBAR, DEFAULT_Z_INDEX, type DataUrlSource, DayChips, DiffEditor, type DiffEditorProps, type DisabledWhenRule, Editor, type EditorContextValue, type EditorFile, type EditorOptions, type EditorProps, EditorProvider, type EditorRef, EmptyState, type EmptyStateProps, ErrorBanner, type ErrorBannerProps, type ErrorFallbackProps, ErrorListTemplate, FieldTemplate, type HLSSource, HOTKEYS, type HistoryPage, type HttpTransportConfig, type ImageFile, ImageViewer, type ImageViewerProps, type JsonFormContext, type JsonFormDensity, JsonSchemaForm, type JsonSchemaFormProps, JsonTreeComponent as JsonTree, type JsonTreeConfig, type JsonTreeProps, JumpToLatest, type JumpToLatestProps, LIMITS, LazyPlayer as LazyAudioPlayer, LazyChat, type ChatRootProps as LazyChatProps, LazyCronScheduler, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyTree, TreeRootProps as LazyTreeProps, LazyVideoPlayer, LazyWrapper, type LazyWrapperProps, type LinkRule, LoadingFallback, type LoadingFallbackProps, type LottieDirection, LottiePlayer, type LottiePlayerProps, type LottieSize, type LottieSpeed, type MapContainerProps, MapLoadingFallback, type MapStyleKey, type MapViewport, MarkdownEditor, type MarkdownEditorProps, MarkdownMessage, type MarkdownMessageProps, type MarkerData, type MentionAttrs, type MentionConfig, type MentionItem, type MentionMarkdownRenderer, Mermaid, type MermaidProps, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, MessageList, type MessageListProps, type MockTransportOptions, type MonthDay, MonthDayGrid, NativeProvider, NumberWidget, ObjectFieldTemplate, Playground as OpenapiViewer, type ParseSSEOptions, type PlayerMode, type PlaygroundConfig, type PlaygroundProps$1 as PlaygroundProps, PrettyCode, type PrettyCodeProps$1 as PrettyCodeProps, type ResolveFileSourceOptions, STORAGE_KEYS, SchedulePreview, type ScheduleType, ScheduleTypeSelector, type SchemaSource, SelectWidget, type SendOptions, type SessionInfo, type SimpleStreamSource, SliderWidget, Sources, type SourcesProps, Spinner, type StreamOptions, StreamProvider, type StreamSource, StreamingIndicator, type StreamingIndicatorProps, SwitchWidget, TextWidget, TimeSelector, type TokenBuffer, ToolCalls, type ToolCallsProps, type ToolPayloadFallback, type ToolPayloadKind, type ToolPayloadMatcher, TransportError, TreeRootProps, type UiGroup, type UrlSource, type UseChatAudioReturn, type UseChatComposerOptions, type UseChatComposerReturn, type UseChatConfig, type UseChatHistoryOptions, type UseChatLayoutConfig, type UseChatLayoutReturn, type UseChatLightboxReturn, type UseChatReturn, type UseChatScrollOptions, type UseChatScrollReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseEditorReturn, type UseLottieOptions, type UseLottieReturn, type UseMonacoReturn, VideoControls, VideoErrorFallback, type VideoErrorFallbackProps, VideoPlayer, type VideoPlayerContextValue, type VideoPlayerProps, VideoPlayerProvider, type VideoPlayerProviderProps, type VideoPlayerRef, type VideoSourceUnion, VidstackProvider, type VimeoSource, type WeekDay, type YouTubeSource, buildCron, collectImageAttachments, createHttpTransport, createId, createLazyComponent, createMockTransport, createTokenBuffer, createVideoErrorFallback, deriveInitials, dispatchToolPayload, evaluateDisabledWhen, extractTextFromChildren, generateContentKey, getChatLogger, getRequiredFields, hasRequiredFields, humanizeCron, initialState, isGeoJSONFeatureCollection, isLatLng, isPlainObject, isSimpleStreamSource, isStringValue, isValidCron, mentionPresets, mergeDefaults, normalizeFormData, parseCron, parseSSE, reducer, resolveFileSource, resolvePersona, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, useAudioCache, useBlobUrlCleanup, useChat, useChatAudio, useChatAudioPrefs, useChatComposer, useChatContext, useChatContextOptional, useChatHistory, useChatLayout, useChatLightbox, useChatScroll, useCollapsibleContent, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays, useEditor, useEditorContext, useImageCache, useLanguage, useLottie, useMediaCacheStore, useMonaco, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, validateRequiredFields, validateSchema };
+export { type ApiKey, ArrayFieldItemTemplate, ArrayFieldTemplate, type AspectRatioValue, type AttachmentRenderer, type AttachmentRendererArgs, type AttachmentRendererMap, Attachments, AttachmentsGrid, type AttachmentsGridProps, AttachmentsList, type AttachmentsListProps, type AttachmentsProps, Player as AudioPlayer, type PlayerProps as AudioPlayerProps, AudioToggle, type AudioToggleProps, BaseInputTemplate, type BlobSource, CHAT_EVENT_NAME, CSS_VARS, CardLoadingFallback, type ChatAction, type ChatAssistantContext, type ChatAttachment, type ChatAudioConfig, type ChatAudioEvent, type ChatAudioSounds, type ChatConfig, type ChatContextValue, type ChatDisplayMode, type ChatEventDetail, type ChatLabels, type ChatLightboxState, type ChatLogScope, type ChatLogger, type ChatMessage, type ChatPersona, type ChatPrefs, ChatProvider, type ChatProviderProps, type ChatRole, ChatRoot, type ChatRootProps, type ChatSource, type ChatState, type ChatStreamEvent, type ChatToolCall, type ChatTransport, type ChatUserContext, CheckboxWidget, ColorWidget, Composer, type ComposerProps, type CreateLazyComponentOptions, type CreateSessionOptions, type CreateVideoErrorFallbackOptions, CronScheduler, type CronSchedulerContextValue, type CronSchedulerProps, CronSchedulerProvider, type CronSchedulerState, CustomInput, type DASHSource, DEFAULT_LABELS, DEFAULT_SIDEBAR, DEFAULT_Z_INDEX, type DataUrlSource, DayChips, DiffEditor, type DiffEditorProps, type DisabledWhenRule, Editor, type EditorContextValue, type EditorFile, type EditorOptions, type EditorProps, EditorProvider, type EditorRef, EmptyState, type EmptyStateProps, ErrorBanner, type ErrorBannerProps, type ErrorFallbackProps, ErrorListTemplate, FieldTemplate, type HLSSource, HOTKEYS, type HistoryPage, type HttpTransportConfig, type ImageFile, ImageViewer, type ImageViewerProps, type JsonFormContext, type JsonFormDensity, JsonSchemaForm, type JsonSchemaFormProps, JsonTreeComponent as JsonTree, type JsonTreeConfig, type JsonTreeProps, JumpToLatest, type JumpToLatestProps, LIMITS, LazyPlayer as LazyAudioPlayer, LazyChat, type ChatRootProps as LazyChatProps, LazyCronScheduler, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyTree, TreeRootProps as LazyTreeProps, LazyVideoPlayer, LazyWrapper, type LazyWrapperProps, type LinkRule, LoadingFallback, type LoadingFallbackProps, type LottieDirection, LottiePlayer, type LottiePlayerProps, type LottieSize, type LottieSpeed, type MapContainerProps, MapLoadingFallback, type MapStyleKey, type MapViewport, MarkdownEditor, type MarkdownEditorProps, MarkdownMessage, type MarkdownMessageProps, type MarkerData, type MentionAttrs, type MentionConfig, type MentionItem, type MentionMarkdownRenderer, Mermaid, type MermaidProps, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, MessageList, type MessageListHandle, type MessageListProps, type MockTransportOptions, type MonthDay, MonthDayGrid, NativeProvider, NumberWidget, ObjectFieldTemplate, Playground as OpenapiViewer, type ParseSSEOptions, type PlayerMode, type PlaygroundConfig, type PlaygroundProps$1 as PlaygroundProps, PrettyCode, type PrettyCodeProps$1 as PrettyCodeProps, type ResolveFileSourceOptions, STORAGE_KEYS, SchedulePreview, type ScheduleType, ScheduleTypeSelector, type SchemaSource, SelectWidget, type SendOptions, type SessionInfo, type SimpleStreamSource, SliderWidget, Sources, type SourcesProps, Spinner, type StreamOptions, StreamProvider, type StreamSource, StreamingIndicator, type StreamingIndicatorProps, SwitchWidget, TextWidget, TimeSelector, type TokenBuffer, ToolCalls, type ToolCallsProps, type ToolPayloadFallback, type ToolPayloadKind, type ToolPayloadMatcher, TransportError, TreeRootProps, type UiGroup, type UrlSource, type UseChatAudioReturn, type UseChatComposerOptions, type UseChatComposerReturn, type UseChatConfig, type UseChatHistoryOptions, type UseChatLayoutConfig, type UseChatLayoutReturn, type UseChatLightboxReturn, type UseChatReturn, type UseChatScrollOptions, type UseChatScrollReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseEditorReturn, type UseLottieOptions, type UseLottieReturn, type UseMonacoReturn, VideoControls, VideoErrorFallback, type VideoErrorFallbackProps, VideoPlayer, type VideoPlayerContextValue, type VideoPlayerProps, VideoPlayerProvider, type VideoPlayerProviderProps, type VideoPlayerRef, type VideoSourceUnion, VidstackProvider, type VimeoSource, type WeekDay, type YouTubeSource, buildCron, collectImageAttachments, createHttpTransport, createId, createLazyComponent, createMockTransport, createTokenBuffer, createVideoErrorFallback, deriveInitials, dispatchToolPayload, evaluateDisabledWhen, extractTextFromChildren, generateContentKey, getChatLogger, getRequiredFields, hasRequiredFields, humanizeCron, initialState, isGeoJSONFeatureCollection, isLatLng, isPlainObject, isSimpleStreamSource, isStringValue, isValidCron, mentionPresets, mergeDefaults, normalizeFormData, parseCron, parseSSE, reducer, resolveFileSource, resolvePersona, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, useAudioCache, useBlobUrlCleanup, useChat, useChatAudio, useChatAudioPrefs, useChatComposer, useChatContext, useChatContextOptional, useChatHistory, useChatLayout, useChatLightbox, useChatScroll, useCollapsibleContent, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays, useEditor, useEditorContext, useImageCache, useLanguage, useLottie, useMediaCacheStore, useMonaco, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, validateRequiredFields, validateSchema };

package/dist/index.mjs

@@ -5,8 +5,8 @@ export { NativeProvider, StreamProvider, VideoControls, VideoErrorFallback, Vide
 export { ImageViewer } from './chunk-OBRSGM64.mjs';
 export { generateContentKey, useAudioCache, useBlobUrlCleanup, useImageCache, useMediaCacheStore, useVideoCache, useVideoPlayerSettings } from './chunk-C6GXVH5J.mjs';
 export { CronSchedulerProvider, CustomInput, DayChips, MonthDayGrid, SchedulePreview, ScheduleTypeSelector, TimeSelector, buildCron, humanizeCron, isValidCron, parseCron, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays } from './chunk-PVAX67JG.mjs';
-import { LIMITS, createId, useChatAudioPrefs, useChatContextOptional } from './chunk-WGU5BEZX.mjs';
-export { Attachments, AttachmentsGrid, AttachmentsList, CHAT_EVENT_NAME, CSS_VARS, ChatProvider, ChatRoot, Composer, DEFAULT_LABELS, DEFAULT_SIDEBAR, DEFAULT_Z_INDEX, EmptyState, ErrorBanner, HOTKEYS, JumpToLatest, LIMITS, MessageActions, MessageBubble, MessageList, STORAGE_KEYS, Sources, StreamingIndicator, ToolCalls, createId, createTokenBuffer, deriveInitials, getChatLogger, initialState, reducer, resolvePersona, useChat, useChatAudio, useChatAudioPrefs, useChatComposer, useChatContext, useChatContextOptional, useChatHistory, useChatLayout, useChatScroll } from './chunk-WGU5BEZX.mjs';
+import { LIMITS, createId, useChatAudioPrefs, useChatContextOptional } from './chunk-MVAT6OPZ.mjs';
+export { Attachments, AttachmentsGrid, AttachmentsList, CHAT_EVENT_NAME, CSS_VARS, ChatProvider, ChatRoot, Composer, DEFAULT_LABELS, DEFAULT_SIDEBAR, DEFAULT_Z_INDEX, EmptyState, ErrorBanner, HOTKEYS, JumpToLatest, LIMITS, MessageActions, MessageBubble, MessageList, STORAGE_KEYS, Sources, StreamingIndicator, ToolCalls, createId, createTokenBuffer, deriveInitials, getChatLogger, initialState, reducer, resolvePersona, useChat, useChatAudio, useChatAudioPrefs, useChatComposer, useChatContext, useChatContextOptional, useChatLayout } from './chunk-MVAT6OPZ.mjs';
 export { TreeError, TreeSkeleton, createDemoTree } from './chunk-B6IR5KSC.mjs';
 export { DEFAULT_TREE_APPEARANCE, DEFAULT_TREE_LABELS, TreeRoot as Tree, TreeChevron, TreeContent, TreeEmpty, TreeIcon, TreeIndentGuides, TreeLabel, TreeProvider, TreeRoot, TreeRow, TreeSearchInput, appearanceToStyle, clearTreeState, createChildCache, flattenTree, loadTreeState, resolveAppearance, resolveChildren, saveTreeState, useTreeActions, useTreeContext, useTreeExpansion, useTreeFocus, useTreeKeyboard, useTreeLabels, useTreeRows, useTreeSearch, useTreeSelection, useTreeTypeAhead } from './chunk-ZL7FH4NW.mjs';
 import { PlaygroundProvider } from './chunk-Y6UTOBF6.mjs';
@@ -348,7 +348,7 @@ var LazyTree = createLazyComponent(
   }
 );
 var LazyChat = createLazyComponent(
-  () => import('./ChatRoot-6U7633X3.mjs').then((m) => ({ default: m.ChatRoot })),
+  () => import('./ChatRoot-DYMCNGOB.mjs').then((m) => ({ default: m.ChatRoot })),
   {
     displayName: "LazyChat",
     fallback: /* @__PURE__ */ jsx(LoadingFallback, { minHeight: 320, text: "Loading chat\u2026" })
@@ -650,6 +650,138 @@ function createMockTransport(opts = {}) {
   };
 }
 __name(createMockTransport, "createMockTransport");
+function useChatScroll(options) {
+  const {
+    containerRef,
+    bottomRef,
+    isStreaming = false,
+    bottomThresholdPx = 80,
+    messagesCount = 0
+  } = options;
+  const [isAtBottom, setIsAtBottom] = useState(true);
+  const [unreadCount, setUnreadCount] = useState(0);
+  const lastCountRef = useRef(messagesCount);
+  const stickyRef = useRef(true);
+  const wasStreamingRef = useRef(isStreaming);
+  const scrollToBottom = useCallback(
+    (smooth = false) => {
+      const el = containerRef.current;
+      if (!el) return;
+      el.scrollTo({
+        top: el.scrollHeight,
+        behavior: smooth ? "smooth" : "auto"
+      });
+      stickyRef.current = true;
+      setIsAtBottom(true);
+      setUnreadCount(0);
+    },
+    [containerRef]
+  );
+  const resetUnread = useCallback(() => setUnreadCount(0), []);
+  useEffect(() => {
+    const el = containerRef.current;
+    if (!el) return;
+    const onScroll = /* @__PURE__ */ __name(() => {
+      const distance = el.scrollHeight - el.scrollTop - el.clientHeight;
+      const atBottom = distance <= bottomThresholdPx;
+      stickyRef.current = atBottom;
+      setIsAtBottom(atBottom);
+      if (atBottom) setUnreadCount(0);
+    }, "onScroll");
+    onScroll();
+    el.addEventListener("scroll", onScroll, { passive: true });
+    return () => {
+      el.removeEventListener("scroll", onScroll);
+    };
+  }, [containerRef, bottomThresholdPx]);
+  useEffect(() => {
+    const el = containerRef.current;
+    if (!el) return;
+    if (isStreaming) {
+      wasStreamingRef.current = true;
+      if (!stickyRef.current) return;
+      let raf = 0;
+      const tick = /* @__PURE__ */ __name(() => {
+        if (!stickyRef.current) return;
+        el.scrollTop = el.scrollHeight;
+        raf = requestAnimationFrame(tick);
+      }, "tick");
+      raf = requestAnimationFrame(tick);
+      return () => cancelAnimationFrame(raf);
+    }
+    if (wasStreamingRef.current && stickyRef.current) {
+      wasStreamingRef.current = false;
+      let raf1 = 0;
+      let raf2 = 0;
+      raf1 = requestAnimationFrame(() => {
+        el.scrollTop = el.scrollHeight;
+        raf2 = requestAnimationFrame(() => {
+          el.scrollTop = el.scrollHeight;
+        });
+      });
+      return () => {
+        cancelAnimationFrame(raf1);
+        cancelAnimationFrame(raf2);
+      };
+    }
+    wasStreamingRef.current = false;
+    return;
+  }, [containerRef, isStreaming]);
+  useEffect(() => {
+    if (messagesCount > lastCountRef.current) {
+      if (stickyRef.current) {
+        const el = containerRef.current;
+        if (el) el.scrollTop = el.scrollHeight;
+      } else {
+        setUnreadCount((n) => n + (messagesCount - lastCountRef.current));
+      }
+    }
+    lastCountRef.current = messagesCount;
+  }, [containerRef, messagesCount]);
+  useEffect(() => {
+  }, [bottomRef]);
+  return { isAtBottom, unreadCount, scrollToBottom, resetUnread };
+}
+__name(useChatScroll, "useChatScroll");
+function useChatHistory(options) {
+  const { enabled = true, containerRef, topSentinelRef, hasMore, isLoadingMore, loadMore } = options;
+  const heightBeforeRef = useRef(null);
+  useEffect(() => {
+    if (heightBeforeRef.current == null) return;
+    const el = containerRef.current;
+    if (!el) {
+      heightBeforeRef.current = null;
+      return;
+    }
+    if (!isLoadingMore) {
+      const delta = el.scrollHeight - heightBeforeRef.current;
+      if (delta > 0) {
+        el.scrollTop += delta;
+      }
+      heightBeforeRef.current = null;
+    }
+  }, [containerRef, isLoadingMore]);
+  useEffect(() => {
+    if (!enabled || !hasMore) return;
+    const sentinel = topSentinelRef.current;
+    const root = containerRef.current;
+    if (!sentinel || !root) return;
+    const observer = new IntersectionObserver(
+      (entries) => {
+        const entry = entries[0];
+        if (!entry?.isIntersecting) return;
+        if (isLoadingMore) return;
+        const el = containerRef.current;
+        if (el) heightBeforeRef.current = el.scrollHeight;
+        void loadMore();
+      },
+      { root, threshold: 0, rootMargin: "200px 0px 0px 0px" }
+    );
+    observer.observe(sentinel);
+    return () => observer.disconnect();
+  }, [enabled, hasMore, isLoadingMore, containerRef, topSentinelRef, loadMore]);
+}
+__name(useChatHistory, "useChatHistory");
 function useChatLightbox() {
   const [state, setState] = useState(null);
   const open = useCallback((att, gallery) => {
@@ -1761,6 +1893,6 @@ function MarkdownToolbar({ editor }) {
 }
 __name(MarkdownToolbar, "MarkdownToolbar");
 
-export { AudioToggle, CardLoadingFallback, CronScheduler, DiffEditor, Editor, EditorProvider, LazyPlayer as LazyAudioPlayer, LazyChat, LazyCronScheduler, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyTree, LazyVideoPlayer, LazyWrapper, LoadingFallback, LottiePlayer, MapLoadingFallback, MarkdownEditor, OpenapiViewer_default as OpenapiViewer, Spinner, TransportError, collectImageAttachments, createHttpTransport, createLazyComponent, createMockTransport, dispatchToolPayload, isGeoJSONFeatureCollection, isLatLng, isPlainObject, isStringValue, mentionPresets, parseSSE, useChatLightbox, useEditor, useEditorContext, useLanguage, useMonaco };
+export { AudioToggle, CardLoadingFallback, CronScheduler, DiffEditor, Editor, EditorProvider, LazyPlayer as LazyAudioPlayer, LazyChat, LazyCronScheduler, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyTree, LazyVideoPlayer, LazyWrapper, LoadingFallback, LottiePlayer, MapLoadingFallback, MarkdownEditor, OpenapiViewer_default as OpenapiViewer, Spinner, TransportError, collectImageAttachments, createHttpTransport, createLazyComponent, createMockTransport, dispatchToolPayload, isGeoJSONFeatureCollection, isLatLng, isPlainObject, isStringValue, mentionPresets, parseSSE, useChatHistory, useChatLightbox, useChatScroll, useEditor, useEditorContext, useLanguage, useMonaco };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map