@agno-hq/chat-react 0.3.0 → 0.3.1

package/dist/chat/index.d.cts

@@ -1,6 +1,5 @@
 import { C as ChatMessage, l as RunEventData, e as ChatStatus, g as EntityType, q as ToolExecution, m as RunRequirement, S as SessionEntry, A as AgnoClient, E as Entity, j as ReferenceData, f as Citations$1, R as ReasoningStep, o as SubRun, r as WorkflowStep, I as ImageData, V as VideoData, c as AudioData } from '../client-DUyVqxU9.cjs';
-import * as React$1 from 'react';
-import React__default from 'react';
+import React$1 from 'react';
 import { StreamdownProps } from 'streamdown';
 
 /**
@@ -163,6 +162,10 @@ interface ChatClassNames {
     attachButton?: string;
     /** Pending attachment chips. */
     files?: string;
+    /** The "why this file was refused" line under the chips. */
+    fileError?: string;
+    /** The overlay shown while files are dragged over the dock. */
+    dropOverlay?: string;
     /** `<SessionList>` wrapper. */
     sessions?: string;
     /** Each session row. */
@@ -256,6 +259,17 @@ interface LinkPreview {
  */
 type ResolveLinkPreview = (url: string) => Promise<LinkPreview | null> | LinkPreview | null;
 /** One numbered entry in a message's source list. */
+/**
+ * Renders every link the components emit — in answers, on `[1]` chips and on
+ * source cards — in place of a plain `<a>`. Given `href`, `children` and the
+ * anchor attributes the component would have set (class, title, ARIA); it
+ * decides how to navigate, so nothing sets `target` for it. Hand it a router
+ * link to keep in-app URLs client-side.
+ */
+type LinkComponent = React$1.ComponentType<React$1.AnchorHTMLAttributes<HTMLAnchorElement> & {
+    href: string;
+    children?: React$1.ReactNode;
+}>;
 interface Source {
     /** 1-based position — what `[1]` in the answer text refers to. */
     index: number;
@@ -377,6 +391,11 @@ interface MarkdownProps {
      * it, or set `codeCopy` on `<ChatProvider>` to turn it off everywhere.
      */
     codeCopy?: boolean;
+    /**
+     * Render links with your own component instead of `<a>` — a router link
+     * keeps in-app URLs client-side. Defaults to the provider's `linkComponent`.
+     */
+    linkComponent?: LinkComponent;
     /** Escape hatch onto Streamdown itself — anything not set here. */
     options?: Omit<StreamdownProps, 'children' | 'className' | 'components'>;
 }
@@ -392,8 +411,8 @@ interface MarkdownProps {
  * fallbacks, and because the failure paths are worth testing.
  */
 declare function writeClipboard(text: string): Promise<boolean>;
-declare function Markdown({ content, className, sources, streaming, codeCopy, options, }: MarkdownProps): React__default.ReactElement;
-type RenderMarkdown = (content: string) => React__default.ReactNode;
+declare function Markdown({ content, className, sources, streaming, codeCopy, linkComponent, options, }: MarkdownProps): React$1.ReactElement;
+type RenderMarkdown = (content: string) => React$1.ReactNode;
 
 /**
  * `<ChatProvider>` runs a chat and shares it with everything below it, so the
@@ -424,9 +443,11 @@ interface ChatContextValue {
     resolveLinkPreview?: ResolveLinkPreview;
     /** Whether fenced code blocks carry a copy button. Defaults to true. */
     codeCopy?: boolean;
+    /** Renders every link in place of `<a>`, threaded to every descendant. */
+    linkComponent?: LinkComponent;
 }
 interface ChatProviderProps extends UseAgnoChatOptions {
-    children: React__default.ReactNode;
+    children: React$1.ReactNode;
     /** Slot class overrides shared by every component in the tree. */
     classNames?: ChatClassNames;
     /** Markdown renderer shared by every component in the tree. */
@@ -443,6 +464,12 @@ interface ChatProviderProps extends UseAgnoChatOptions {
      * by default; pass `false` to drop it.
      */
     codeCopy?: boolean;
+    /**
+     * Render every link — in answers, on `[1]` chips, on source cards — with
+     * your own component instead of `<a>`. A router link keeps in-app URLs
+     * client-side; see `LinkComponent`.
+     */
+    linkComponent?: LinkComponent;
     /**
      * Use an existing `useAgnoChat` result instead of creating one. Lets a parent
      * own the state (or share one chat across two providers).
@@ -452,13 +479,13 @@ interface ChatProviderProps extends UseAgnoChatOptions {
      * Wrapper element rendered around the children. Defaults to a plain `div`
      * carrying the theme classes; pass `false` to render children bare.
      */
-    as?: React__default.ElementType | false;
+    as?: React$1.ElementType | false;
     className?: string;
     /** Light theme instead of the default dark. */
     light?: boolean;
-    style?: React__default.CSSProperties;
+    style?: React$1.CSSProperties;
 }
-declare function ChatProvider({ children, classNames, renderMarkdown, resolveLinkPreview, codeCopy, chat: externalChat, as, className, light, style, ...options }: ChatProviderProps): React__default.ReactElement;
+declare function ChatProvider({ children, classNames, renderMarkdown, resolveLinkPreview, codeCopy, linkComponent, chat: externalChat, as, className, light, style, ...options }: ChatProviderProps): React$1.ReactElement;
 /**
  * Read the chat, class overrides, markdown renderer and link-preview resolver
  * provided by the nearest `<ChatProvider>`. Throws outside a provider — use the
@@ -469,6 +496,8 @@ declare function useChatContext(): ChatContextValue;
 declare function useOptionalChatContext(): ChatContextValue | null;
 /** The chat instance, from the prop if given, otherwise from context. */
 declare function useResolvedChat(explicit?: UseAgnoChat): UseAgnoChat;
+/** The provider's link component, if one was supplied. */
+declare function useLinkComponent(): LinkComponent | undefined;
 /** Merge the provider's class overrides with any passed directly. */
 declare function useResolvedClassNames(explicit?: ChatClassNames): ChatClassNames;
 
@@ -486,7 +515,7 @@ type LauncherPosition = 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left
 type LauncherPanel = 'popover' | 'fullscreen';
 interface ChatLauncherProps {
     /** The chat surface to reveal — usually `<AgnoChat>` or `<ChatWindow>`. */
-    children: React__default.ReactNode;
+    children: React$1.ReactNode;
     /** Corner to pin to. Default "bottom-right". */
     position?: LauncherPosition;
     /** Distance from both edges of that corner. Number means px. Default 24. */
@@ -505,7 +534,7 @@ interface ChatLauncherProps {
     /** Text beside the bubble glyph, e.g. "Chat with us". Icon-only without it. */
     label?: string;
     /** Replaces the default speech-bubble glyph. */
-    icon?: React__default.ReactNode;
+    icon?: React$1.ReactNode;
     /** Accessible name for the bubble. Default "Open chat" / "Close chat". */
     ariaLabel?: string;
     /** Close on Escape. Default true. */
@@ -524,7 +553,7 @@ interface ChatLauncherProps {
     portal?: boolean;
     className?: string;
 }
-declare function ChatLauncher({ children, position, offset, panel, width, height, open, defaultOpen, onOpenChange, label, icon, ariaLabel, closeOnEscape, bubbleWhenOpen, keepMounted, portal, className, }: ChatLauncherProps): React__default.ReactElement | null;
+declare function ChatLauncher({ children, position, offset, panel, width, height, open, defaultOpen, onOpenChange, label, icon, ariaLabel, closeOnEscape, bubbleWhenOpen, keepMounted, portal, className, }: ChatLauncherProps): React$1.ReactElement | null;
 
 /**
  * Suggested-prompt chips — the "what can I ask?" row a support chat shows on an
@@ -546,7 +575,7 @@ interface QuickPromptsProps {
     disabled?: boolean;
     className?: string;
 }
-declare function QuickPrompts({ prompts, onSelect, disabled, className, }: QuickPromptsProps): React__default.ReactElement | null;
+declare function QuickPrompts({ prompts, onSelect, disabled, className, }: QuickPromptsProps): React$1.ReactElement | null;
 
 /**
  * Zero-wiring chat widget. Point it at an AgentOS URL and it discovers the
@@ -592,6 +621,8 @@ interface AgnoChatProps {
     placeholder?: string;
     /** Show the attach-files control. Default true, as the AgentOS dock does. */
     allowFiles?: boolean;
+    /** The one-row composer instead of the dock. Suits a launcher or a sidebar. */
+    compactInput?: boolean;
     /** Show the past-sessions sidebar. Default false. */
     showSessions?: boolean;
     /** Render the last run error above the input. Default false. */
@@ -605,7 +636,7 @@ interface AgnoChatProps {
      */
     hideFollowups?: boolean;
     /** Heading over the follow-ups. Default "Related questions"; `null` for none. */
-    followupsTitle?: React__default.ReactNode | null;
+    followupsTitle?: React$1.ReactNode | null;
     renderMarkdown?: RenderMarkdown;
     /**
      * Fill link previews with your own OpenGraph metadata. Called once per URL,
@@ -614,21 +645,23 @@ interface AgnoChatProps {
     resolveLinkPreview?: ResolveLinkPreview;
     /** Put a copy button on fenced code blocks. Defaults to true. */
     codeCopy?: boolean;
+    /** Render every link with your own component — a router link, say. */
+    linkComponent?: LinkComponent;
     /**
      * Your own header/toolbar, rendered above the chat. Nothing by default —
      * the embed ships without chrome so it drops into yours.
      */
-    header?: React__default.ReactNode;
+    header?: React$1.ReactNode;
     /** Rendered below the chat, outside the composer. */
-    footer?: React__default.ReactNode;
+    footer?: React$1.ReactNode;
     /** Empty-state copy shown before the first message. */
-    emptyState?: React__default.ReactNode;
+    emptyState?: React$1.ReactNode;
     /** Light theme instead of the default dark. */
     light?: boolean;
     className?: string;
     /** Per-slot class overrides — see `ChatClassNames`. */
     classNames?: ChatClassNames;
-    style?: React__default.CSSProperties;
+    style?: React$1.CSSProperties;
     /**
      * "inline" (default) renders the chat where you put it. "launcher" pins a
      * support-style bubble to a corner of the viewport that opens the chat.
@@ -646,14 +679,38 @@ interface AgnoChatProps {
     /** Launcher only: text beside the bubble glyph, e.g. "Chat with us". */
     launcherLabel?: string;
     /** Launcher only: replaces the default speech-bubble glyph. */
-    launcherIcon?: React__default.ReactNode;
+    launcherIcon?: React$1.ReactNode;
     /** Launcher only: open on first render. Default false. */
     defaultOpen?: boolean;
     /** Launcher only: controlled open state. Pair with `onOpenChange`. */
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
 }
-declare function AgnoChat(props: AgnoChatProps): React__default.ReactElement;
+declare function AgnoChat(props: AgnoChatProps): React$1.ReactElement;
+
+/** Scrollable transcript that auto-sticks to the bottom while streaming. */
+
+interface MessageListProps {
+    /** Omit inside a `<ChatProvider>` to use the provider's transcript. */
+    messages?: ChatMessage[];
+    status?: ChatStatus;
+    activity?: string | null;
+    renderMarkdown?: RenderMarkdown;
+    emptyState?: React$1.ReactNode;
+    /** What is answering — picks the agent avatar. */
+    entityType?: EntityType;
+    /** Initials shown on the user avatar. Defaults to AgentOS's "ME". */
+    userInitials?: string;
+    /** Rendered after the last message (e.g. a human-in-the-loop panel). */
+    footer?: React$1.ReactNode;
+    /** Rendered above the first message, inside the scroll area. */
+    header?: React$1.ReactNode;
+    /** Replace how each message is rendered. */
+    renderMessage?: (message: ChatMessage, activity?: string | null) => React$1.ReactNode;
+    className?: string;
+    classNames?: ChatClassNames;
+}
+declare function MessageList({ messages, status, activity, renderMarkdown, emptyState, entityType, userInitials, footer, header, renderMessage, className, classNames, }: MessageListProps): React$1.ReactElement;
 
 /**
  * A complete chat surface built from a `useAgnoChat` result. Pass the hook's
@@ -670,8 +727,10 @@ interface ChatWindowProps {
     placeholder?: string;
     /** Initials shown on the user avatar. Defaults to AgentOS's "ME". */
     userInitials?: string;
-    emptyState?: React__default.ReactNode;
+    emptyState?: React$1.ReactNode;
     allowFiles?: boolean;
+    /** The one-row composer instead of the dock — see `<ChatInput compact>`. */
+    compactInput?: boolean;
     disabled?: boolean;
     renderMarkdown?: RenderMarkdown;
     /**
@@ -689,39 +748,17 @@ interface ChatWindowProps {
     /** What a follow-up does. Defaults to sending it as the next message. */
     onFollowup?: (prompt: string) => void;
     /** Heading over the follow-ups. Default "Related questions"; `null` for none. */
-    followupsTitle?: React__default.ReactNode | null;
+    followupsTitle?: React$1.ReactNode | null;
+    /** Replace how each message is rendered — see `<MessageList>`. */
+    renderMessage?: MessageListProps['renderMessage'];
     /** Rendered above the transcript (your own toolbar, title, tabs…). */
-    header?: React__default.ReactNode;
+    header?: React$1.ReactNode;
     /** Replace the composer entirely. Pass `false` for a read-only transcript. */
-    composer?: React__default.ReactNode | false;
+    composer?: React$1.ReactNode | false;
     className?: string;
     classNames?: ChatClassNames;
 }
-declare function ChatWindow({ chat: chatProp, placeholder, userInitials, emptyState, allowFiles, disabled, renderMarkdown, showErrors, quickPrompts, onQuickPrompt, hideFollowups, onFollowup, followupsTitle, header, composer, className, classNames, }: ChatWindowProps): React__default.ReactElement;
-
-/** Scrollable transcript that auto-sticks to the bottom while streaming. */
-
-interface MessageListProps {
-    /** Omit inside a `<ChatProvider>` to use the provider's transcript. */
-    messages?: ChatMessage[];
-    status?: ChatStatus;
-    activity?: string | null;
-    renderMarkdown?: RenderMarkdown;
-    emptyState?: React__default.ReactNode;
-    /** What is answering — picks the agent avatar. */
-    entityType?: EntityType;
-    /** Initials shown on the user avatar. Defaults to AgentOS's "ME". */
-    userInitials?: string;
-    /** Rendered after the last message (e.g. a human-in-the-loop panel). */
-    footer?: React__default.ReactNode;
-    /** Rendered above the first message, inside the scroll area. */
-    header?: React__default.ReactNode;
-    /** Replace how each message is rendered. */
-    renderMessage?: (message: ChatMessage, activity?: string | null) => React__default.ReactNode;
-    className?: string;
-    classNames?: ChatClassNames;
-}
-declare function MessageList({ messages, status, activity, renderMarkdown, emptyState, entityType, userInitials, footer, header, renderMessage, className, classNames, }: MessageListProps): React__default.ReactElement;
+declare function ChatWindow({ chat: chatProp, placeholder, userInitials, emptyState, allowFiles, compactInput, disabled, renderMarkdown, showErrors, quickPrompts, onQuickPrompt, hideFollowups, onFollowup, followupsTitle, renderMessage, header, composer, className, classNames, }: ChatWindowProps): React$1.ReactElement;
 
 /** Renders a single chat message: content, tools, reasoning, media, citations, follow-ups. */
 
@@ -748,44 +785,111 @@ interface MessageProps {
      */
     onFollowup?: (prompt: string) => void;
     /** Replace the avatar entirely. Pass `false` to drop it. */
-    avatar?: React__default.ReactNode | false;
+    avatar?: React$1.ReactNode | false;
     /** Rendered after the message content, inside the body. */
-    children?: React__default.ReactNode;
+    children?: React$1.ReactNode;
     className?: string;
     classNames?: ChatClassNames;
 }
-declare function Message({ message, renderMarkdown, activity, avatar, children, className, classNames, entityType, userInitials, hideReasoning, hideTools, hideSources, onFollowup, }: MessageProps): React__default.ReactElement;
+declare function Message({ message, renderMarkdown, activity, avatar, children, className, classNames, entityType, userInitials, hideReasoning, hideTools, hideSources, onFollowup, }: MessageProps): React$1.ReactElement;
 
 /**
  * The AgentOS chat dock: a rounded card holding an auto-growing textarea and a
  * bottom action row (attach on the left, send/stop on the right).
+ *
+ * It works as-is, and it also opens up for a host that needs more from the
+ * composer than a textarea — an @mention menu, context chips, a highlighted
+ * draft — without forking it:
+ *
+ * - `value` / `onValueChange` make the draft controlled.
+ * - `textareaProps` reach the textarea itself (key handlers, ARIA); a key
+ *   handler that calls `preventDefault()` stops Enter from sending.
+ * - `renderTextarea` swaps the element for your own, given the props this one
+ *   would have had — for a mirror-highlighted input, say.
+ * - `above` and `below` render inside the dock, around the field.
+ * - Dropped files land in the attachment tray, subject to `accept` and the
+ *   size limits; the first reason a file was refused shows under the tray.
  */
 
-interface ChatInputProps {
-    /** Omit inside a `<ChatProvider>` to send through the provider's chat. */
-    onSend?: (message: string, files?: File[]) => void;
+/** What the textarea receives — and what `renderTextarea` is handed. */
+type ChatTextareaProps = React$1.TextareaHTMLAttributes<HTMLTextAreaElement> & {
+    ref: React$1.Ref<HTMLTextAreaElement>;
+};
+interface FileLimits {
+    /** Accepted extensions and/or MIME types, as the file picker takes them: `".md,.py,image/*"`. */
+    accept?: string;
+    /** Most files attached at once. */
+    maxFiles?: number;
+    /** Largest single file, in bytes. */
+    maxFileSize?: number;
+    /** Largest total across every attached file, in bytes. */
+    maxTotalSize?: number;
+}
+interface ChatInputProps extends FileLimits {
+    /**
+     * Omit inside a `<ChatProvider>` to send through the provider's chat. Return
+     * `false` (or a promise of it) to keep the draft — the send did not happen.
+     */
+    onSend?: (message: string, files?: File[]) => void | boolean | Promise<void | boolean>;
     onStop?: () => void;
     disabled?: boolean;
     busy?: boolean;
     placeholder?: string;
     /** Allow attaching files. */
     allowFiles?: boolean;
+    /**
+     * One row — the field with the buttons beside it — instead of the dock with
+     * its action row beneath. For a sidebar, a launcher, anywhere narrow.
+     */
+    compact?: boolean;
+    /** The draft, when you own it. Pair with `onValueChange`. */
+    value?: string;
+    onValueChange?: (value: string) => void;
+    /** Reach the textarea element. */
+    textareaRef?: React$1.Ref<HTMLTextAreaElement>;
+    /**
+     * Spread onto the textarea. Its `onKeyDown` runs before the Enter-to-send
+     * handling; call `preventDefault()` there to claim a key.
+     */
+    textareaProps?: React$1.TextareaHTMLAttributes<HTMLTextAreaElement>;
+    /**
+     * Replace the textarea with your own element, given the props this one would
+     * have rendered with. Your element sizes itself.
+     */
+    renderTextarea?: (props: ChatTextareaProps) => React$1.ReactNode;
+    /** Rendered inside the dock, above the attachment tray and the field. */
+    above?: React$1.ReactNode;
+    /** Rendered inside the dock, between the field and the action row. */
+    below?: React$1.ReactNode;
+    /** Text shown while files are dragged over the dock. */
+    dropLabel?: string;
     /** Rendered in the left action group — where the entity picker sits. */
-    leading?: React__default.ReactNode;
+    leading?: React$1.ReactNode;
     /** Rendered in the right action group, before send. */
-    trailing?: React__default.ReactNode;
+    trailing?: React$1.ReactNode;
     className?: string;
     classNames?: ChatClassNames;
 }
-declare function ChatInput({ onSend, onStop, disabled, busy, placeholder, allowFiles, leading, trailing, className, classNames, }: ChatInputProps): React__default.ReactElement;
+/** Does the file match an `accept` list, by extension or MIME type? */
+declare function fileAccepted(file: File, accept?: string): boolean;
+/**
+ * Apply the limits to files being added. Every limit is enforced; the message
+ * names the first reason something was left out.
+ */
+declare function admitFiles(current: readonly File[], incoming: readonly File[], limits: FileLimits): {
+    files: File[];
+    error: string | null;
+};
+declare function ChatInput({ onSend, onStop, disabled, busy, placeholder, allowFiles, compact, accept, maxFiles, maxFileSize, maxTotalSize, value: controlled, onValueChange, textareaRef: externalRef, textareaProps, renderTextarea, above, below, dropLabel, leading, trailing, className, classNames, }: ChatInputProps): React$1.ReactElement;
 
 /**
  * Attachment previews, shown in a banner above the composer field — the
  * AgentOS `FileUpload` banner: a count with a "clear all" control, then a
  * horizontally scrolling row of items.
  *
- * Images render as a thumbnail; everything else as a card with a file-type
- * mark, the name, and the MIME type.
+ * Images render as a bordered thumbnail; everything else as a card with a
+ * file-type mark, the name, and a `TYPE • SIZE` label. Every item carries its
+ * remove control as a tab folded into the top-right corner.
  */
 
 interface FilePreviewProps {
@@ -794,7 +898,7 @@ interface FilePreviewProps {
     onClear?: () => void;
     className?: string;
 }
-declare function FilePreview({ files, onRemove, onClear, className }: FilePreviewProps): React__default.ReactElement | null;
+declare function FilePreview({ files, onRemove, onClear, className }: FilePreviewProps): React$1.ReactElement | null;
 
 /**
  * The AgentOS "behind the scenes" panel: everything the run did on its way to
@@ -862,7 +966,7 @@ declare function behindTheScenesItems(message: ChatMessage, opts?: Options): Beh
 declare function hasBehindTheScenes(message: ChatMessage, opts?: Options): boolean;
 /** The trigger label, mirroring AgentOS's `getBehindTheScenesLabel`. */
 declare function behindTheScenesLabel(message: ChatMessage, streaming?: boolean, activity?: string | null): string;
-declare function BehindTheScenes({ message, streaming, activity, renderMarkdown, defaultOpen, hideReasoning, hideTools, className, classNames, }: BehindTheScenesProps): React__default.ReactElement | null;
+declare function BehindTheScenes({ message, streaming, activity, renderMarkdown, defaultOpen, hideReasoning, hideTools, className, classNames, }: BehindTheScenesProps): React$1.ReactElement | null;
 
 /**
  * Tool calls, rendered the AgentOS way: a row of compact uppercase pills above
@@ -872,14 +976,14 @@ declare function BehindTheScenes({ message, streaming, activity, renderMarkdown,
 
 declare function ToolCalls({ tools }: {
     tools?: ToolExecution[];
-}): React__default.ReactElement | null;
+}): React$1.ReactElement | null;
 
 /** Renders a message's reasoning steps in a collapsible timeline. */
 
 declare function Reasoning({ steps, defaultOpen, }: {
     steps?: ReasoningStep[];
     defaultOpen?: boolean;
-}): React__default.ReactElement | null;
+}): React$1.ReactElement | null;
 
 /**
  * Renders the nested runs of a team or workflow turn — each team member's
@@ -891,7 +995,7 @@ declare function MemberResponses({ members, renderMarkdown, title, }: {
     members?: SubRun[];
     renderMarkdown?: RenderMarkdown;
     title?: string;
-}): React__default.ReactElement | null;
+}): React$1.ReactElement | null;
 
 /**
  * Renders the steps of a workflow run as an ordered progress list, each with a
@@ -902,7 +1006,7 @@ declare function WorkflowSteps({ steps, renderMarkdown, title, }: {
     steps?: WorkflowStep[];
     renderMarkdown?: RenderMarkdown;
     title?: string;
-}): React__default.ReactElement | null;
+}): React$1.ReactElement | null;
 
 /**
  * The sources behind an answer, as cards.
@@ -923,23 +1027,26 @@ interface CitationsProps {
      * `citations` — pass it when the inline markers were numbered elsewhere.
      */
     sources?: Source[];
-    /** Heading above the cards. Defaults to "Sources". */
+    /** Heading above the cards. Defaults to "Sources used". */
     title?: string;
-    /** Cards shown before the "more" toggle. Defaults to 4; `0` shows them all. */
+    /**
+     * Pills shown in the row. The rest sit behind a "+N more" pill that opens a
+     * list on hover. Defaults to 3; `0` puts every source in the row.
+     */
     max?: number;
     className?: string;
     classNames?: ChatClassNames;
 }
 /**
- * One card: the site's favicon and the title, linking to the source. The
- * number, URL and cited passage live on the hover card — a row of cards under
- * an answer only needs to say where it can take you.
+ * One card: the site's favicon, the title and a link mark, linking to the
+ * source. The number, URL and cited passage live on the hover card — a row of
+ * cards under an answer only needs to say where it can take you.
  */
 declare function SourceCard({ source, className, }: {
     source: Source;
     className?: string;
-}): React__default.ReactElement;
-declare function Citations({ references, citations, sources: given, title, max, className, classNames, }: CitationsProps): React__default.ReactElement | null;
+}): React$1.ReactElement;
+declare function Citations({ references, citations, sources: given, title, max, className, classNames, }: CitationsProps): React$1.ReactElement | null;
 
 /**
  * "Related questions" — the follow-up prompts an agent suggests after its
@@ -960,7 +1067,7 @@ interface FollowupsProps {
     /** Called with the prompt text to send. */
     onSelect: (prompt: string) => void;
     /** Heading above the list. Pass `null` for none. Default "Related questions". */
-    title?: React__default.ReactNode | null;
+    title?: React$1.ReactNode | null;
     /**
      * Lines each prompt may take before it is cut with an ellipsis. Default 1;
      * `false` lets them wrap.
@@ -975,7 +1082,7 @@ interface FollowupsProps {
 }
 /** Trim, drop empties, and keep the first of any duplicates (case-insensitively). */
 declare function normalizeFollowups(items?: readonly string[] | null): string[];
-declare function Followups({ items, onSelect, title, lines, max, disabled, className, classNames, }: FollowupsProps): React__default.ReactElement | null;
+declare function Followups({ items, onSelect, title, lines, max, disabled, className, classNames, }: FollowupsProps): React$1.ReactElement | null;
 
 /**
  * Link previews: the little card that describes where a citation points.
@@ -1005,7 +1112,7 @@ declare function Favicon({ url, kind, size, className, }: {
     kind?: Source['kind'];
     size?: number;
     className?: string;
-}): React__default.ReactElement;
+}): React$1.ReactElement;
 interface LinkPreviewCardProps {
     source: Source;
     /** Resolved metadata, when a `resolveLinkPreview` returned some. */
@@ -1017,11 +1124,11 @@ interface LinkPreviewCardProps {
  * The preview body: site row, title, description. Shared by the hover card and
  * the source cards under a message, so the two always agree.
  */
-declare function LinkPreviewCard({ source, preview, loading, className, }: LinkPreviewCardProps): React__default.ReactElement;
+declare function LinkPreviewCard({ source, preview, loading, className, }: LinkPreviewCardProps): React$1.ReactElement;
 interface HoverPreviewProps {
     source: Source;
     /** The trigger — a citation marker or a link in the answer. */
-    children: React__default.ReactElement;
+    children: React$1.ReactElement;
     /** Turn the hover card off and render the trigger bare. */
     disabled?: boolean;
     className?: string;
@@ -1031,7 +1138,7 @@ interface HoverPreviewProps {
  * reveals the preview card. Escape dismisses it; the card is reachable with the
  * pointer, so links inside it stay clickable.
  */
-declare function HoverPreview({ source, children, disabled, className, }: HoverPreviewProps): React__default.ReactElement;
+declare function HoverPreview({ source, children, disabled, className, }: HoverPreviewProps): React$1.ReactElement;
 
 /** Renders images, videos and audio attached to a message. */
 
@@ -1040,14 +1147,14 @@ declare function Multimedia({ images, videos, audio, responseAudio, }: {
     videos?: VideoData[];
     audio?: AudioData[];
     responseAudio?: AudioData;
-}): React__default.ReactElement | null;
+}): React$1.ReactElement | null;
 
 /** A live status line showing what the run is currently doing. */
 
 declare function StatusIndicator({ status, activity, }: {
     status: ChatStatus;
     activity?: string | null;
-}): React__default.ReactElement | null;
+}): React$1.ReactElement | null;
 
 /**
  * A developer-facing live feed of run events. Consecutive repeats of the same
@@ -1060,7 +1167,7 @@ declare function EventLog({ events, autoScroll, maxHeight, }: {
     events: RunEventData[];
     autoScroll?: boolean;
     maxHeight?: number;
-}): React__default.ReactElement;
+}): React$1.ReactElement;
 
 /**
  * Human-in-the-loop panel, styled after the Agno OS chat HITL cards.
@@ -1082,7 +1189,7 @@ interface HumanInputProps {
     }) => void;
     className?: string;
 }
-declare function HumanInput({ message, entityType, busy, onResolve, className, }: HumanInputProps): React__default.ReactElement | null;
+declare function HumanInput({ message, entityType, busy, onResolve, className, }: HumanInputProps): React$1.ReactElement | null;
 
 /**
  * Entity picker styled after the Agno OS chat selector: a compact bordered
@@ -1099,7 +1206,7 @@ declare function EntitySelector({ entities, value, onChange, disabled, placehold
     placeholder?: string;
     className?: string;
     classNames?: ChatClassNames;
-}): React__default.ReactElement;
+}): React$1.ReactElement;
 
 /**
  * The selected agent/team/workflow, shown read-only in the composer row — the
@@ -1120,7 +1227,7 @@ interface EntityBadgeProps {
     hideModel?: boolean;
     className?: string;
 }
-declare function EntityBadge({ entity, placeholder, hideModel, className, }: EntityBadgeProps): React__default.ReactElement | null;
+declare function EntityBadge({ entity, placeholder, hideModel, className, }: EntityBadgeProps): React$1.ReactElement | null;
 
 /**
  * Model-provider marks, shown on the selected-entity badge in the composer.
@@ -1141,7 +1248,7 @@ interface ProviderIconProps {
  * all land on the same logo. Returns null when nothing matches, and the badge
  * then falls back to the model name as text.
  */
-declare function getProviderIcon(value?: string): ((props: ProviderIconProps) => React__default.ReactElement) | null;
+declare function getProviderIcon(value?: string): ((props: ProviderIconProps) => React$1.ReactElement) | null;
 
 /**
  * A sidebar listing the past sessions of the selected entity. Clicking a
@@ -1166,7 +1273,7 @@ interface SessionListProps {
     className?: string;
     classNames?: ChatClassNames;
 }
-declare function SessionList({ sessions, activeSessionId, streamingSessionIds, loading, onSelect, onDelete, onNew, title, hideTitle, className, classNames, }: SessionListProps): React__default.ReactElement;
+declare function SessionList({ sessions, activeSessionId, streamingSessionIds, loading, onSelect, onDelete, onNew, title, hideTitle, className, classNames, }: SessionListProps): React$1.ReactElement;
 
 /**
  * The icon set.
@@ -1188,38 +1295,41 @@ type IconProps = {
     size?: number;
     className?: string;
 };
-declare const ChevronDown: ({ size, className }: IconProps) => React__default.ReactElement;
-declare const ArrowUp: ({ size, className }: IconProps) => React__default.ReactElement;
-declare const Paperclip: ({ size, className }: IconProps) => React__default.ReactElement;
-declare const FileIcon: ({ size, className }: IconProps) => React__default.ReactElement;
-declare const FileAudio: ({ size, className }: IconProps) => React__default.ReactElement;
-declare const FileVideo: ({ size, className }: IconProps) => React__default.ReactElement;
-declare const Wrench: ({ size, className }: IconProps) => React__default.ReactElement;
-declare const BookOpen: ({ size, className }: IconProps) => React__default.ReactElement;
-declare const Globe: ({ size, className }: IconProps) => React__default.ReactElement;
-declare const Brain: ({ size, className }: IconProps) => React__default.ReactElement;
-declare const Box: ({ size, className }: IconProps) => React__default.ReactElement;
-declare const Plus: ({ size, className }: IconProps) => React__default.ReactElement;
-declare const Check: ({ size, className }: IconProps) => React__default.ReactElement;
-declare const Copy: ({ size, className }: IconProps) => React__default.ReactElement;
-declare const Close: ({ size, className }: IconProps) => React__default.ReactElement;
+declare const ChevronDown: ({ size, className }: IconProps) => React$1.ReactElement;
+declare const ArrowUp: ({ size, className }: IconProps) => React$1.ReactElement;
+declare const Paperclip: ({ size, className }: IconProps) => React$1.ReactElement;
+declare const FileIcon: ({ size, className }: IconProps) => React$1.ReactElement;
+declare const FileType: ({ size, className }: IconProps) => React$1.ReactElement;
+declare const FileAudio: ({ size, className }: IconProps) => React$1.ReactElement;
+declare const FileVideo: ({ size, className }: IconProps) => React$1.ReactElement;
+declare const Wrench: ({ size, className }: IconProps) => React$1.ReactElement;
+declare const BookOpen: ({ size, className }: IconProps) => React$1.ReactElement;
+declare const Globe: ({ size, className }: IconProps) => React$1.ReactElement;
+/** Trailing mark on a source pill. */
+declare const LinkIcon: ({ size, className }: IconProps) => React$1.ReactElement;
+declare const Brain: ({ size, className }: IconProps) => React$1.ReactElement;
+declare const Box: ({ size, className }: IconProps) => React$1.ReactElement;
+declare const Plus: ({ size, className }: IconProps) => React$1.ReactElement;
+declare const Check: ({ size, className }: IconProps) => React$1.ReactElement;
+declare const Copy: ({ size, className }: IconProps) => React$1.ReactElement;
+declare const Close: ({ size, className }: IconProps) => React$1.ReactElement;
 /** Memory-update steps. */
-declare const Memory: ({ size, className }: IconProps) => React__default.ReactElement;
+declare const Memory: ({ size, className }: IconProps) => React$1.ReactElement;
 /** Run-continued marker. */
-declare const Rerun: ({ size, className }: IconProps) => React__default.ReactElement;
-declare const Pulse: ({ size, className }: IconProps) => React__default.ReactElement;
-declare const Trash: ({ size, className }: IconProps) => React__default.ReactElement;
-declare const ChatBubble: ({ size, className }: IconProps) => React__default.ReactElement;
-declare const Spinner: ({ size, className }: IconProps) => React__default.ReactElement;
+declare const Rerun: ({ size, className }: IconProps) => React$1.ReactElement;
+declare const Pulse: ({ size, className }: IconProps) => React$1.ReactElement;
+declare const Trash: ({ size, className }: IconProps) => React$1.ReactElement;
+declare const ChatBubble: ({ size, className }: IconProps) => React$1.ReactElement;
+declare const Spinner: ({ size, className }: IconProps) => React$1.ReactElement;
 /** The stop control is a filled square, not an outline. */
-declare function Stop({ size, className }: IconProps): React__default.ReactElement;
+declare function Stop({ size, className }: IconProps): React$1.ReactElement;
 /** The Agno mark — used as the agent avatar, exactly as in AgentOS. */
-declare function AgnoMark({ size, className }: IconProps): React__default.ReactElement;
+declare function AgnoMark({ size, className }: IconProps): React$1.ReactElement;
 /** The AgentOS `team` glyph, drawn in the current colour. */
-declare function TeamGlyph({ size, className }: IconProps): React__default.ReactElement;
+declare function TeamGlyph({ size, className }: IconProps): React$1.ReactElement;
 /** The grid loader AgentOS shows while a run is working. */
 declare function GridLoader({ className }: {
     className?: string;
-}): React__default.ReactElement;
+}): React$1.ReactElement;
 
-export { AgnoChat, type AgnoChatProps, AgnoMark, ArrowUp, BehindTheScenes, type BehindTheScenesProps, BookOpen, Box, Brain, ChatBubble, type ChatClassNames, type ChatContextValue, ChatInput, type ChatInputProps, ChatLauncher, type ChatLauncherProps, ChatProvider, type ChatProviderProps, ChatWindow, type ChatWindowProps, Check, ChevronDown, Citations, type CitationsProps, Close, Copy, EntityBadge, type EntityBadgeProps, EntitySelector, EventLog, Favicon, FileAudio, FileIcon, FilePreview, type FilePreviewProps, FileVideo, Followups, type FollowupsProps, Globe, GridLoader, HoverPreview, type HoverPreviewProps, HumanInput, type HumanInputProps, type LauncherPanel, type LauncherPosition, type LinkPreview, LinkPreviewCard, type LinkPreviewCardProps, Markdown, type MarkdownProps, MemberResponses, Memory, Message, MessageList, type MessageListProps, type MessageProps, Multimedia, Paperclip, Plus, Pulse, type QuickPrompt, QuickPrompts, type QuickPromptsProps, Reasoning, type RenderMarkdown, Rerun, type ResolveLinkPreview, type SendOptions, SessionList, type SessionListProps, type Source, SourceCard, SourcesProvider, Spinner, StatusIndicator, Stop, TeamGlyph, ToolCalls, Trash, type UseAgnoChat, type UseAgnoChatOptions, WorkflowSteps, Wrench, behindTheScenesItems, behindTheScenesLabel, collectSources, displayUrl, faviconUrl, getProviderIcon, hasBehindTheScenes, linkCitations, normalizeFollowups, quickPromptLabel, quickPromptText, sourceHost, sourcesFromMarkdown, useAgnoChat, useChatContext, useLinkPreview, useOptionalChatContext, useResolvedChat, useResolvedClassNames, useSources, withoutSourcesLine, writeClipboard };
+export { AgnoChat, type AgnoChatProps, AgnoMark, ArrowUp, BehindTheScenes, type BehindTheScenesProps, BookOpen, Box, Brain, ChatBubble, type ChatClassNames, type ChatContextValue, ChatInput, type ChatInputProps, ChatLauncher, type ChatLauncherProps, ChatProvider, type ChatProviderProps, type ChatTextareaProps, ChatWindow, type ChatWindowProps, Check, ChevronDown, Citations, type CitationsProps, Close, Copy, EntityBadge, type EntityBadgeProps, EntitySelector, EventLog, Favicon, FileAudio, FileIcon, type FileLimits, FilePreview, type FilePreviewProps, FileType, FileVideo, Followups, type FollowupsProps, Globe, GridLoader, HoverPreview, type HoverPreviewProps, HumanInput, type HumanInputProps, type LauncherPanel, type LauncherPosition, type LinkComponent, LinkIcon, type LinkPreview, LinkPreviewCard, type LinkPreviewCardProps, Markdown, type MarkdownProps, MemberResponses, Memory, Message, MessageList, type MessageListProps, type MessageProps, Multimedia, Paperclip, Plus, Pulse, type QuickPrompt, QuickPrompts, type QuickPromptsProps, Reasoning, type RenderMarkdown, Rerun, type ResolveLinkPreview, type SendOptions, SessionList, type SessionListProps, type Source, SourceCard, SourcesProvider, Spinner, StatusIndicator, Stop, TeamGlyph, ToolCalls, Trash, type UseAgnoChat, type UseAgnoChatOptions, WorkflowSteps, Wrench, admitFiles, behindTheScenesItems, behindTheScenesLabel, collectSources, displayUrl, faviconUrl, fileAccepted, getProviderIcon, hasBehindTheScenes, linkCitations, normalizeFollowups, quickPromptLabel, quickPromptText, sourceHost, sourcesFromMarkdown, useAgnoChat, useChatContext, useLinkComponent, useLinkPreview, useOptionalChatContext, useResolvedChat, useResolvedClassNames, useSources, withoutSourcesLine, writeClipboard };