@agno-hq/chat-react 0.3.1 → 0.3.3

package/dist/chat/index.d.ts

@@ -148,6 +148,10 @@ interface ChatClassNames {
     markdown?: string;
     /** "Working…" line shown while streaming with no content yet. */
     activity?: string;
+    /** `<MessageActions>` — the icon row under a finished answer. */
+    messageActions?: string;
+    /** The copy button in that row. */
+    messageCopyButton?: string;
     /** `<ChatInput>` wrapper. */
     input?: string;
     /** Row holding attach / textarea / send. */
@@ -291,8 +295,12 @@ declare function sourceHost(url?: string): string | undefined;
 /**
  * The site's own icon. Same-origin to the site being cited, so no third-party
  * favicon service is involved and nothing is requested until a card renders.
+ * `/favicon.ico` by convention; `/favicon.svg` is the next guess, for sites
+ * that only declare an SVG icon (see `faviconFallbacks`).
  */
 declare function faviconUrl(url?: string): string | undefined;
+/** Every same-origin icon path worth trying, in order. Empty for a bad URL. */
+declare function faviconFallbacks(url?: string): string[];
 /** `docs.agno.com/introduction` — the host plus a trimmed path, for card chrome. */
 declare function displayUrl(url?: string): string | undefined;
 /**
@@ -356,6 +364,36 @@ declare const SourcesProvider: React$1.Provider<Source[]>;
 /** The sources of the surrounding message; empty outside one. */
 declare function useSources(): Source[];
 
+/**
+ * The copy control — one component wherever something can be copied: the
+ * header of a fenced code block, the action row under an answer, a host's own
+ * surface. It owns the "copied" flash and the clipboard fallbacks, so every
+ * copy affordance in a transcript behaves the same way.
+ */
+
+/**
+ * Copy text, by whichever route the browser allows.
+ *
+ * The async Clipboard API is the right one, but it rejects on an insecure
+ * origin and whenever the document isn't focused — so a selection-based copy
+ * stands behind it. Returns whether anything was actually copied: the button
+ * should not claim success it didn't have.
+ *
+ * Exported because a host building its own copy affordance wants the same
+ * fallbacks, and because the failure paths are worth testing.
+ */
+declare function writeClipboard(text: string): Promise<boolean>;
+interface CopyButtonProps {
+    /** What to copy — a string, or a function for text that is costly to build. */
+    text: string | (() => string);
+    /** Accessible name and tooltip. Defaults to "Copy". */
+    label?: string;
+    /** Icon size, in px. */
+    size?: number;
+    className?: string;
+}
+declare function CopyButton({ text, label, size, className }: CopyButtonProps): React$1.ReactElement;
+
 /**
  * Markdown for a chat transcript, rendered by [Streamdown](https://streamdown.ai).
  *
@@ -399,18 +437,6 @@ interface MarkdownProps {
     /** Escape hatch onto Streamdown itself — anything not set here. */
     options?: Omit<StreamdownProps, 'children' | 'className' | 'components'>;
 }
-/**
- * Copy text, by whichever route the browser allows.
- *
- * The async Clipboard API is the right one, but it rejects on an insecure
- * origin and whenever the document isn't focused — so a selection-based copy
- * stands behind it. Returns whether anything was actually copied: the button
- * should not claim success it didn't have.
- *
- * Exported because a host building its own copy affordance wants the same
- * fallbacks, and because the failure paths are worth testing.
- */
-declare function writeClipboard(text: string): Promise<boolean>;
 declare function Markdown({ content, className, sources, streaming, codeCopy, linkComponent, options, }: MarkdownProps): React$1.ReactElement;
 type RenderMarkdown = (content: string) => React$1.ReactNode;
 
@@ -778,6 +804,10 @@ interface MessageProps {
     hideTools?: boolean;
     /** Hide the sources block under the answer. */
     hideSources?: boolean;
+    /** Hide the action row (copy, and whatever `actions` adds) under the answer. */
+    hideActions?: boolean;
+    /** More actions for the row, after copy — regenerate, feedback, and so on. */
+    actions?: React$1.ReactNode;
     /**
      * Render the "Related questions" the agent suggested under this message,
      * sending the clicked one here. Off by default: `<ChatWindow>` pins them
@@ -791,7 +821,26 @@ interface MessageProps {
     className?: string;
     classNames?: ChatClassNames;
 }
-declare function Message({ message, renderMarkdown, activity, avatar, children, className, classNames, entityType, userInitials, hideReasoning, hideTools, hideSources, onFollowup, }: MessageProps): React$1.ReactElement;
+declare function Message({ message, renderMarkdown, activity, avatar, children, className, classNames, entityType, userInitials, hideReasoning, hideTools, hideSources, hideActions, actions, onFollowup, }: MessageProps): React$1.ReactElement;
+
+/**
+ * The action row under a finished answer — the Figma `_Chat messages/Actions`
+ * strip: small icon buttons in a line, copy first. The package ships copy;
+ * anything a product adds (regenerate, feedback, "view JSON") goes in as
+ * children and lines up with it.
+ */
+
+interface MessageActionsProps {
+    /** The message the actions apply to; copy takes its content. */
+    message: ChatMessage;
+    /** Leave the copy button out (a host that copies differently). */
+    hideCopy?: boolean;
+    /** More actions, rendered after copy. */
+    children?: React$1.ReactNode;
+    className?: string;
+    classNames?: ChatClassNames;
+}
+declare function MessageActions({ message, hideCopy, children, className, classNames, }: MessageActionsProps): React$1.ReactElement | null;
 
 /**
  * The AgentOS chat dock: a rounded card holding an auto-growing textarea and a
@@ -1106,7 +1155,10 @@ declare function useLinkPreview(url: string | undefined, enabled: boolean): {
     preview: LinkPreview | null;
     loading: boolean;
 };
-/** The site's icon, falling back to a glyph when the origin serves none. */
+/**
+ * The site's icon: `/favicon.ico`, then `/favicon.svg`, then a glyph when the
+ * origin serves neither.
+ */
 declare function Favicon({ url, kind, size, className, }: {
     url?: string;
     kind?: Source['kind'];
@@ -1321,8 +1373,11 @@ 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$1.ReactElement;
+/**
+ * The stop control: AgentOS's `square-stop`, a small outlined square in the
+ * same button the arrow sends from — 10.67px in a 32px or 24px button.
+ */
+declare const 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$1.ReactElement;
 /** The AgentOS `team` glyph, drawn in the current colour. */
@@ -1332,4 +1387,4 @@ declare function GridLoader({ className }: {
     className?: string;
 }): 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, 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 };
+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, CopyButton, type CopyButtonProps, 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, MessageActions, type MessageActionsProps, 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, faviconFallbacks, faviconUrl, fileAccepted, getProviderIcon, hasBehindTheScenes, linkCitations, normalizeFollowups, quickPromptLabel, quickPromptText, sourceHost, sourcesFromMarkdown, useAgnoChat, useChatContext, useLinkComponent, useLinkPreview, useOptionalChatContext, useResolvedChat, useResolvedClassNames, useSources, withoutSourcesLine, writeClipboard };

package/dist/chat/index.js

@@ -1,5 +1,5 @@
 'use client';
-export { AgnoChat, AgnoMark, ArrowUp, BehindTheScenes, BookOpen, Box, Brain, ChatBubble, ChatInput, ChatLauncher, ChatProvider, ChatWindow, Check, ChevronDown, Citations, Close, Copy, EntityBadge, EntitySelector, EventLog, Favicon, FileAudio, FileIcon, FilePreview, FileType, FileVideo, Followups, Globe, GridLoader, HoverPreview, HumanInput, LinkIcon, LinkPreviewCard, Markdown, MemberResponses, Memory, Message, MessageList, Multimedia, Paperclip, Plus, Pulse, QuickPrompts, Reasoning, Rerun, SessionList, SourceCard, SourcesProvider, Spinner, StatusIndicator, Stop, TeamGlyph, ToolCalls, Trash, 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 } from '../chunk-BZC2674Z.js';
+export { AgnoChat, AgnoMark, ArrowUp, BehindTheScenes, BookOpen, Box, Brain, ChatBubble, ChatInput, ChatLauncher, ChatProvider, ChatWindow, Check, ChevronDown, Citations, Close, Copy, CopyButton, EntityBadge, EntitySelector, EventLog, Favicon, FileAudio, FileIcon, FilePreview, FileType, FileVideo, Followups, Globe, GridLoader, HoverPreview, HumanInput, LinkIcon, LinkPreviewCard, Markdown, MemberResponses, Memory, Message, MessageActions, MessageList, Multimedia, Paperclip, Plus, Pulse, QuickPrompts, Reasoning, Rerun, SessionList, SourceCard, SourcesProvider, Spinner, StatusIndicator, Stop, TeamGlyph, ToolCalls, Trash, WorkflowSteps, Wrench, admitFiles, behindTheScenesItems, behindTheScenesLabel, collectSources, displayUrl, faviconFallbacks, faviconUrl, fileAccepted, getProviderIcon, hasBehindTheScenes, linkCitations, normalizeFollowups, quickPromptLabel, quickPromptText, sourceHost, sourcesFromMarkdown, useAgnoChat, useChatContext, useLinkComponent, useLinkPreview, useOptionalChatContext, useResolvedChat, useResolvedClassNames, useSources, withoutSourcesLine, writeClipboard } from '../chunk-E4CFQ457.js';
 import '../chunk-6V2YIPHF.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map