@lukeashford/aurelius 2.11.0 → 2.12.0

package/dist/index.d.mts

@@ -629,8 +629,17 @@ interface MessageActionsConfig {
     showCopy?: boolean;
 }
 interface MessageProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Whether the message is from the user or the assistant
+     */
     variant?: MessageVariant;
+    /**
+     * The message content (supports Markdown)
+     */
     content: string;
+    /**
+     * Whether the message is currently being streamed (shows cursor)
+     */
     isStreaming?: boolean;
     /**
      * Branch navigation info (shows branch indicator if provided and total > 1)
@@ -726,6 +735,17 @@ interface ChatInputProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'o
      */
     acceptedFileTypes?: string;
 }
+/**
+ * ChatInput is a context-aware input component that can transition between
+ * a centered position (for empty states) and a bottom position (for active conversations).
+ *
+ * Features:
+ * - Auto-expanding textarea
+ * - File attachments with preview
+ * - Drag and drop support
+ * - Streaming state with stop button
+ * - Animated transition between positions
+ */
 declare const ChatInput: React$1.ForwardRefExoticComponent<ChatInputProps & React$1.RefAttributes<HTMLDivElement>>;
 
 interface Conversation {
@@ -756,6 +776,14 @@ interface ConversationSidebarProps extends React$1.HTMLAttributes<HTMLDivElement
      * Callback to toggle collapse state
      */
     onToggleCollapse?: () => void;
+    /**
+     * Current width of the sidebar (when expanded)
+     */
+    width?: number;
+    /**
+     * Callback to start resizing
+     */
+    onResizeStart?: (e: React$1.MouseEvent) => void;
 }
 /**
  * ConversationSidebar displays a collapsible list of past conversations.
@@ -850,17 +878,14 @@ interface UseArtifactsReturn {
     artifacts: Artifact[];
     /**
      * Schedule a new artifact (adds to list with isPending=true, shows skeleton).
-     * Use when an operator starts processing (e.g., SSE operator.started event).
      */
     scheduleArtifact: (artifact: Omit<Artifact, 'isPending'>) => void;
     /**
      * Show an artifact (updates existing or adds new with isPending=false).
-     * Use when artifact content is ready (e.g., SSE artifact.created event).
      */
     showArtifact: (artifactId: string, artifact: Omit<Artifact, 'id' | 'isPending'>) => void;
     /**
      * Remove an artifact from the list.
-     * Use when artifact generation fails (e.g., SSE operator.failed event).
      */
     removeArtifact: (artifactId: string) => void;
     /**
@@ -894,6 +919,18 @@ interface UseArtifactsReturn {
  */
 declare function useArtifacts(): UseArtifactsReturn;
 
+interface UseResizableProps {
+    initialWidth: number;
+    minWidth: number;
+    maxWidth: number;
+    direction: 'left' | 'right';
+}
+declare function useResizable({ initialWidth, minWidth, maxWidth, direction, }: UseResizableProps): {
+    width: number;
+    isResizing: boolean;
+    startResizing: (e: React.MouseEvent) => void;
+};
+
 /**
  * Conversation Tree Types
  *
@@ -1016,9 +1053,21 @@ declare function messagesToTree(messages: Array<{
 declare function isBranchPoint(tree: ConversationTree, nodeId: string): boolean;
 
 interface ChatMessage {
+    /**
+     * Unique identifier for the message
+     */
     id: string;
+    /**
+     * Whether the message is from the user or the assistant
+     */
     variant: 'user' | 'assistant';
+    /**
+     * Message content (Markdown supported)
+     */
     content: string;
+    /**
+     * Whether the message is currently streaming
+     */
     isStreaming?: boolean;
 }
 interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'onSubmit'> {
@@ -1041,79 +1090,86 @@ interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>
      */
     conversations?: Conversation[];
     /**
-     * Called when a message is submitted
+     * Called when a message is submitted from the input.
+     * Provides the text content and any files attached.
      */
     onMessageSubmit?: (message: string, attachments?: Attachment[]) => void;
     /**
-     * Called when a user message is edited (creates a branch)
+     * Called when a user message is edited.
+     * In tree mode, this creates a new branch.
      */
     onEditMessage?: (messageId: string, newContent: string) => void;
     /**
-     * Called when an assistant message is retried (creates a branch)
+     * Called when an assistant message is retried.
+     * In tree mode, this creates a new branch.
      */
     onRetryMessage?: (messageId: string) => void;
     /**
-     * Called when Stop button is clicked during streaming
+     * Called when the Stop button is clicked during assistant streaming.
      */
     onStop?: () => void;
     /**
-     * Called when a conversation is selected from sidebar
+     * Called when a conversation is selected from the sidebar.
      */
     onSelectConversation?: (id: string) => void;
     /**
-     * Called when "New Chat" is clicked
+     * Called when the "New Chat" button is clicked in the sidebar.
      */
     onNewChat?: () => void;
     /**
-     * Whether the assistant is currently streaming a response
+     * Whether the assistant is currently streaming a response.
+     * Shows a stop button and disables certain actions.
      */
     isStreaming?: boolean;
     /**
-     * Whether to show the thinking indicator (before first response token)
+     * Whether to show the thinking indicator.
+     * Typically shown after a user message but before the first streaming token.
      */
     isThinking?: boolean;
     /**
-     * Input placeholder text
+     * Placeholder text for the main chat input.
      */
     placeholder?: string;
     /**
-     * Helper text shown in empty state
+     * Helper text shown in the empty state (when there are no messages).
      */
     emptyStateHelper?: React$1.ReactNode;
     /**
-     * Initial sidebar collapsed state
+     * Whether the sidebar should be initially collapsed.
      */
     initialSidebarCollapsed?: boolean;
     /**
-     * Custom empty state content
+     * Custom content to show when the conversation is empty.
+     * Overrides the default centered input and helper text.
      */
     emptyState?: React$1.ReactNode;
     /**
-     * Whether to show attachment button
+     * Whether to show the attachment (paperclip) button in the input.
      */
     showAttachmentButton?: boolean;
     /**
-     * Whether to enable message actions (copy, edit, retry)
+     * Whether to enable message-level actions (copy, edit, retry).
      */
     enableMessageActions?: boolean;
     /**
-     * Current attachments for the input
+     * Current attachments for the chat input (controlled).
      */
     attachments?: Attachment[];
     /**
-     * Called when attachments change in the input
+     * Called when attachments are added or removed in the chat input.
      */
     onAttachmentsChange?: (attachments: Attachment[]) => void;
     /**
-     * Artifacts to display in the panel. Controlled by parent via useArtifacts hook.
+     * Artifacts to display in the side panel.
+     * Best managed via the useArtifacts hook and passed here.
      */
     artifacts?: Artifact[];
     /**
-     * Whether the artifacts panel is open (controlled mode)
+     * Whether the artifacts panel is currently open (controlled).
      */
     isArtifactsPanelOpen?: boolean;
     /**
-     * Called when artifacts panel open state changes (controlled mode)
+     * Called when the artifacts panel is opened or closed (controlled).
      */
     onArtifactsPanelOpenChange?: (open: boolean) => void;
 }
@@ -1198,6 +1254,14 @@ interface ArtifactsPanelProps extends React$1.HTMLAttributes<HTMLDivElement> {
      * Whether artifacts are still loading (show skeletons)
      */
     isLoading?: boolean;
+    /**
+     * Current width of the panel (when expanded)
+     */
+    width?: number;
+    /**
+     * Callback to start resizing
+     */
+    onResizeStart?: (e: React$1.MouseEvent) => void;
 }
 /**
  * ArtifactsPanel displays rich content artifacts in a slide-in panel.
@@ -1265,6 +1329,10 @@ interface ThinkingIndicatorProps extends React$1.HTMLAttributes<HTMLDivElement>
      */
     phrases?: string[];
 }
+/**
+ * ThinkingIndicator shows an animated state when the assistant is processing a request
+ * but has not yet started streaming tokens. It cycles through flavorful "thinking" phrases.
+ */
 declare const ThinkingIndicator: React$1.ForwardRefExoticComponent<ThinkingIndicatorProps & React$1.RefAttributes<HTMLDivElement>>;
 
 interface BranchNavigatorProps extends React$1.HTMLAttributes<HTMLDivElement> {
@@ -1293,6 +1361,10 @@ interface BranchNavigatorProps extends React$1.HTMLAttributes<HTMLDivElement> {
      */
     showIcon?: boolean;
 }
+/**
+ * BranchNavigator provides a UI for switching between conversation branches.
+ * Used in the Message component to navigate sibling branches (e.g., "1/3").
+ */
 declare const BranchNavigator: React$1.ForwardRefExoticComponent<BranchNavigatorProps & React$1.RefAttributes<HTMLDivElement>>;
 
 type BrandIconSize = 'sm' | 'md' | 'lg';
@@ -1361,4 +1433,4 @@ declare const SectionHeading: React$1.ForwardRefExoticComponent<SectionHeadingPr
 
 declare const version = "2.0.0";
 
-export { Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, type Artifact, type ArtifactType, ArtifactsPanel, type ArtifactsPanelProps, ArtifactsPanelToggle, type ArtifactsPanelToggleProps, type AspectRatio, type AspectRatioPreset, type Attachment, type AttachmentItem, AttachmentPreview, type AttachmentPreviewProps, type AttachmentStatus, Avatar, type AvatarProps, type AvatarSize, Badge, type BadgeProps, type BadgeVariant, BranchNavigator, type BranchNavigatorProps, BrandIcon, type BrandIconProps, type BrandIconSize, type BrandIconVariant, Breadcrumb, BreadcrumbItem, type BreadcrumbItemProps, BreadcrumbLink, type BreadcrumbLinkProps, type BreadcrumbProps, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Card, type CardBodyProps, type CardFooterProps, type CardHeaderProps, type CardMediaProps, type CardProps, type CardVariant, ChatInput, type ChatInputPosition, type ChatInputProps, ChatInterface, type ChatInterfaceProps, type ChatMessage, ChatView, type ChatViewItem, type ChatViewProps, Checkbox, type CheckboxProps, Col, type ColOffset, type ColOrder, type ColProps, type ColSpan, CollapsedSidebarToggle, type CollapsedSidebarToggleProps, ColorSwatch, type ColorSwatchProps, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerProps, type ContainerSize, type Conversation, ConversationSidebar, type ConversationSidebarProps, type ConversationTree, Divider, type DividerProps, Drawer, type DrawerPosition, type DrawerProps, FileChip, type FileChipProps, type FileChipStatus, HelperText, type HelperTextProps, ImageCard, type ImageCardProps, Input, type InputAddonProps, type InputElementProps, InputGroup, type InputGroupProps, InputLeftAddon, InputLeftElement, type InputProps, InputRightAddon, InputRightElement, InputWrapper, type InputWrapperProps, Label, type LabelProps, List, ListItem, type ListItemProps, ListItemText, type ListItemTextProps, type ListProps, ListSubheader, type ListSubheaderProps, MarkdownContent, type MarkdownContentProps, Menu, MenuContent, type MenuContentProps, MenuItem, type MenuItemProps, MenuLabel, type MenuProps, MenuSeparator, MenuTrigger, type MenuTriggerProps, Message, MessageActions, type MessageActionsConfig, type MessageActionsProps, type MessageActionsVariant, type MessageBranchInfo, type MessageNode, type MessageProps, type MessageVariant, Modal, type ModalProps, Navbar, NavbarBrand, type NavbarBrandProps, NavbarContent, type NavbarContentProps, NavbarDivider, NavbarItem, type NavbarItemProps, NavbarLink, type NavbarLinkProps, type NavbarProps, Pagination, type PaginationProps, Popover, type PopoverAlign, type PopoverPosition, type PopoverProps, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, Radio, type RadioProps, Row, type RowAlign, type RowGutter, type RowJustify, type RowProps, SectionHeading, type SectionHeadingLevel, type SectionHeadingProps, Select, type SelectOption, type SelectProps, Skeleton, type SkeletonProps, Slider, type SliderProps, Spinner, type SpinnerProps, Stack, type StackDirection, type StackGap, type StackProps, type Step, type StepStatus, Stepper, type StepperProps, StreamingCursor, type StreamingCursorProps, Switch, type SwitchProps, Tab, TabList, type TabListProps, TabPanel, type TabPanelProps, type TabProps, Table, TableBody, type TableBodyProps, TableCaption, type TableCaptionProps, TableCell, type TableCellProps, TableFooter, type TableFooterProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableRowProps, Tabs, type TabsProps, Textarea, type TextareaProps, ThinkingIndicator, type ThinkingIndicatorProps, type ToastData, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, Tooltip, type TooltipProps, type UseArtifactsReturn, type UseScrollAnchorOptions, type UseScrollAnchorReturn, type VideoAspectRatio, type VideoAspectRatioPreset, VideoCard, type VideoCardProps, addMessageToTree, createEmptyTree, createPreviewUrl, generateId, getActivePathMessages, getSiblingInfo, isBranchPoint, isImageFile, messagesToTree, revokePreviewUrl, switchBranch, updateNodeContent, useArtifacts, useScrollAnchor, useToast, version };
+export { Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, type Artifact, type ArtifactType, ArtifactsPanel, type ArtifactsPanelProps, ArtifactsPanelToggle, type ArtifactsPanelToggleProps, type AspectRatio, type AspectRatioPreset, type Attachment, type AttachmentItem, AttachmentPreview, type AttachmentPreviewProps, type AttachmentStatus, Avatar, type AvatarProps, type AvatarSize, Badge, type BadgeProps, type BadgeVariant, BranchNavigator, type BranchNavigatorProps, BrandIcon, type BrandIconProps, type BrandIconSize, type BrandIconVariant, Breadcrumb, BreadcrumbItem, type BreadcrumbItemProps, BreadcrumbLink, type BreadcrumbLinkProps, type BreadcrumbProps, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Card, type CardBodyProps, type CardFooterProps, type CardHeaderProps, type CardMediaProps, type CardProps, type CardVariant, ChatInput, type ChatInputPosition, type ChatInputProps, ChatInterface, type ChatInterfaceProps, type ChatMessage, ChatView, type ChatViewItem, type ChatViewProps, Checkbox, type CheckboxProps, Col, type ColOffset, type ColOrder, type ColProps, type ColSpan, CollapsedSidebarToggle, type CollapsedSidebarToggleProps, ColorSwatch, type ColorSwatchProps, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerProps, type ContainerSize, type Conversation, ConversationSidebar, type ConversationSidebarProps, type ConversationTree, Divider, type DividerProps, Drawer, type DrawerPosition, type DrawerProps, FileChip, type FileChipProps, type FileChipStatus, HelperText, type HelperTextProps, ImageCard, type ImageCardProps, Input, type InputAddonProps, type InputElementProps, InputGroup, type InputGroupProps, InputLeftAddon, InputLeftElement, type InputProps, InputRightAddon, InputRightElement, InputWrapper, type InputWrapperProps, Label, type LabelProps, List, ListItem, type ListItemProps, ListItemText, type ListItemTextProps, type ListProps, ListSubheader, type ListSubheaderProps, MarkdownContent, type MarkdownContentProps, Menu, MenuContent, type MenuContentProps, MenuItem, type MenuItemProps, MenuLabel, type MenuProps, MenuSeparator, MenuTrigger, type MenuTriggerProps, Message, MessageActions, type MessageActionsConfig, type MessageActionsProps, type MessageActionsVariant, type MessageBranchInfo, type MessageNode, type MessageProps, type MessageVariant, Modal, type ModalProps, Navbar, NavbarBrand, type NavbarBrandProps, NavbarContent, type NavbarContentProps, NavbarDivider, NavbarItem, type NavbarItemProps, NavbarLink, type NavbarLinkProps, type NavbarProps, Pagination, type PaginationProps, Popover, type PopoverAlign, type PopoverPosition, type PopoverProps, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, Radio, type RadioProps, Row, type RowAlign, type RowGutter, type RowJustify, type RowProps, SectionHeading, type SectionHeadingLevel, type SectionHeadingProps, Select, type SelectOption, type SelectProps, Skeleton, type SkeletonProps, Slider, type SliderProps, Spinner, type SpinnerProps, Stack, type StackDirection, type StackGap, type StackProps, type Step, type StepStatus, Stepper, type StepperProps, StreamingCursor, type StreamingCursorProps, Switch, type SwitchProps, Tab, TabList, type TabListProps, TabPanel, type TabPanelProps, type TabProps, Table, TableBody, type TableBodyProps, TableCaption, type TableCaptionProps, TableCell, type TableCellProps, TableFooter, type TableFooterProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableRowProps, Tabs, type TabsProps, Textarea, type TextareaProps, ThinkingIndicator, type ThinkingIndicatorProps, type ToastData, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, Tooltip, type TooltipProps, type UseArtifactsReturn, type UseScrollAnchorOptions, type UseScrollAnchorReturn, type VideoAspectRatio, type VideoAspectRatioPreset, VideoCard, type VideoCardProps, addMessageToTree, createEmptyTree, createPreviewUrl, generateId, getActivePathMessages, getSiblingInfo, isBranchPoint, isImageFile, messagesToTree, revokePreviewUrl, switchBranch, updateNodeContent, useArtifacts, useResizable, useScrollAnchor, useToast, version };

package/dist/index.d.ts

@@ -629,8 +629,17 @@ interface MessageActionsConfig {
     showCopy?: boolean;
 }
 interface MessageProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Whether the message is from the user or the assistant
+     */
     variant?: MessageVariant;
+    /**
+     * The message content (supports Markdown)
+     */
     content: string;
+    /**
+     * Whether the message is currently being streamed (shows cursor)
+     */
     isStreaming?: boolean;
     /**
      * Branch navigation info (shows branch indicator if provided and total > 1)
@@ -726,6 +735,17 @@ interface ChatInputProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'o
      */
     acceptedFileTypes?: string;
 }
+/**
+ * ChatInput is a context-aware input component that can transition between
+ * a centered position (for empty states) and a bottom position (for active conversations).
+ *
+ * Features:
+ * - Auto-expanding textarea
+ * - File attachments with preview
+ * - Drag and drop support
+ * - Streaming state with stop button
+ * - Animated transition between positions
+ */
 declare const ChatInput: React$1.ForwardRefExoticComponent<ChatInputProps & React$1.RefAttributes<HTMLDivElement>>;
 
 interface Conversation {
@@ -756,6 +776,14 @@ interface ConversationSidebarProps extends React$1.HTMLAttributes<HTMLDivElement
      * Callback to toggle collapse state
      */
     onToggleCollapse?: () => void;
+    /**
+     * Current width of the sidebar (when expanded)
+     */
+    width?: number;
+    /**
+     * Callback to start resizing
+     */
+    onResizeStart?: (e: React$1.MouseEvent) => void;
 }
 /**
  * ConversationSidebar displays a collapsible list of past conversations.
@@ -850,17 +878,14 @@ interface UseArtifactsReturn {
     artifacts: Artifact[];
     /**
      * Schedule a new artifact (adds to list with isPending=true, shows skeleton).
-     * Use when an operator starts processing (e.g., SSE operator.started event).
      */
     scheduleArtifact: (artifact: Omit<Artifact, 'isPending'>) => void;
     /**
      * Show an artifact (updates existing or adds new with isPending=false).
-     * Use when artifact content is ready (e.g., SSE artifact.created event).
      */
     showArtifact: (artifactId: string, artifact: Omit<Artifact, 'id' | 'isPending'>) => void;
     /**
      * Remove an artifact from the list.
-     * Use when artifact generation fails (e.g., SSE operator.failed event).
      */
     removeArtifact: (artifactId: string) => void;
     /**
@@ -894,6 +919,18 @@ interface UseArtifactsReturn {
  */
 declare function useArtifacts(): UseArtifactsReturn;
 
+interface UseResizableProps {
+    initialWidth: number;
+    minWidth: number;
+    maxWidth: number;
+    direction: 'left' | 'right';
+}
+declare function useResizable({ initialWidth, minWidth, maxWidth, direction, }: UseResizableProps): {
+    width: number;
+    isResizing: boolean;
+    startResizing: (e: React.MouseEvent) => void;
+};
+
 /**
  * Conversation Tree Types
  *
@@ -1016,9 +1053,21 @@ declare function messagesToTree(messages: Array<{
 declare function isBranchPoint(tree: ConversationTree, nodeId: string): boolean;
 
 interface ChatMessage {
+    /**
+     * Unique identifier for the message
+     */
     id: string;
+    /**
+     * Whether the message is from the user or the assistant
+     */
     variant: 'user' | 'assistant';
+    /**
+     * Message content (Markdown supported)
+     */
     content: string;
+    /**
+     * Whether the message is currently streaming
+     */
     isStreaming?: boolean;
 }
 interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'onSubmit'> {
@@ -1041,79 +1090,86 @@ interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>
      */
     conversations?: Conversation[];
     /**
-     * Called when a message is submitted
+     * Called when a message is submitted from the input.
+     * Provides the text content and any files attached.
      */
     onMessageSubmit?: (message: string, attachments?: Attachment[]) => void;
     /**
-     * Called when a user message is edited (creates a branch)
+     * Called when a user message is edited.
+     * In tree mode, this creates a new branch.
      */
     onEditMessage?: (messageId: string, newContent: string) => void;
     /**
-     * Called when an assistant message is retried (creates a branch)
+     * Called when an assistant message is retried.
+     * In tree mode, this creates a new branch.
      */
     onRetryMessage?: (messageId: string) => void;
     /**
-     * Called when Stop button is clicked during streaming
+     * Called when the Stop button is clicked during assistant streaming.
      */
     onStop?: () => void;
     /**
-     * Called when a conversation is selected from sidebar
+     * Called when a conversation is selected from the sidebar.
      */
     onSelectConversation?: (id: string) => void;
     /**
-     * Called when "New Chat" is clicked
+     * Called when the "New Chat" button is clicked in the sidebar.
      */
     onNewChat?: () => void;
     /**
-     * Whether the assistant is currently streaming a response
+     * Whether the assistant is currently streaming a response.
+     * Shows a stop button and disables certain actions.
      */
     isStreaming?: boolean;
     /**
-     * Whether to show the thinking indicator (before first response token)
+     * Whether to show the thinking indicator.
+     * Typically shown after a user message but before the first streaming token.
      */
     isThinking?: boolean;
     /**
-     * Input placeholder text
+     * Placeholder text for the main chat input.
      */
     placeholder?: string;
     /**
-     * Helper text shown in empty state
+     * Helper text shown in the empty state (when there are no messages).
      */
     emptyStateHelper?: React$1.ReactNode;
     /**
-     * Initial sidebar collapsed state
+     * Whether the sidebar should be initially collapsed.
      */
     initialSidebarCollapsed?: boolean;
     /**
-     * Custom empty state content
+     * Custom content to show when the conversation is empty.
+     * Overrides the default centered input and helper text.
      */
     emptyState?: React$1.ReactNode;
     /**
-     * Whether to show attachment button
+     * Whether to show the attachment (paperclip) button in the input.
      */
     showAttachmentButton?: boolean;
     /**
-     * Whether to enable message actions (copy, edit, retry)
+     * Whether to enable message-level actions (copy, edit, retry).
      */
     enableMessageActions?: boolean;
     /**
-     * Current attachments for the input
+     * Current attachments for the chat input (controlled).
      */
     attachments?: Attachment[];
     /**
-     * Called when attachments change in the input
+     * Called when attachments are added or removed in the chat input.
      */
     onAttachmentsChange?: (attachments: Attachment[]) => void;
     /**
-     * Artifacts to display in the panel. Controlled by parent via useArtifacts hook.
+     * Artifacts to display in the side panel.
+     * Best managed via the useArtifacts hook and passed here.
      */
     artifacts?: Artifact[];
     /**
-     * Whether the artifacts panel is open (controlled mode)
+     * Whether the artifacts panel is currently open (controlled).
      */
     isArtifactsPanelOpen?: boolean;
     /**
-     * Called when artifacts panel open state changes (controlled mode)
+     * Called when the artifacts panel is opened or closed (controlled).
      */
     onArtifactsPanelOpenChange?: (open: boolean) => void;
 }
@@ -1198,6 +1254,14 @@ interface ArtifactsPanelProps extends React$1.HTMLAttributes<HTMLDivElement> {
      * Whether artifacts are still loading (show skeletons)
      */
     isLoading?: boolean;
+    /**
+     * Current width of the panel (when expanded)
+     */
+    width?: number;
+    /**
+     * Callback to start resizing
+     */
+    onResizeStart?: (e: React$1.MouseEvent) => void;
 }
 /**
  * ArtifactsPanel displays rich content artifacts in a slide-in panel.
@@ -1265,6 +1329,10 @@ interface ThinkingIndicatorProps extends React$1.HTMLAttributes<HTMLDivElement>
      */
     phrases?: string[];
 }
+/**
+ * ThinkingIndicator shows an animated state when the assistant is processing a request
+ * but has not yet started streaming tokens. It cycles through flavorful "thinking" phrases.
+ */
 declare const ThinkingIndicator: React$1.ForwardRefExoticComponent<ThinkingIndicatorProps & React$1.RefAttributes<HTMLDivElement>>;
 
 interface BranchNavigatorProps extends React$1.HTMLAttributes<HTMLDivElement> {
@@ -1293,6 +1361,10 @@ interface BranchNavigatorProps extends React$1.HTMLAttributes<HTMLDivElement> {
      */
     showIcon?: boolean;
 }
+/**
+ * BranchNavigator provides a UI for switching between conversation branches.
+ * Used in the Message component to navigate sibling branches (e.g., "1/3").
+ */
 declare const BranchNavigator: React$1.ForwardRefExoticComponent<BranchNavigatorProps & React$1.RefAttributes<HTMLDivElement>>;
 
 type BrandIconSize = 'sm' | 'md' | 'lg';
@@ -1361,4 +1433,4 @@ declare const SectionHeading: React$1.ForwardRefExoticComponent<SectionHeadingPr
 
 declare const version = "2.0.0";
 
-export { Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, type Artifact, type ArtifactType, ArtifactsPanel, type ArtifactsPanelProps, ArtifactsPanelToggle, type ArtifactsPanelToggleProps, type AspectRatio, type AspectRatioPreset, type Attachment, type AttachmentItem, AttachmentPreview, type AttachmentPreviewProps, type AttachmentStatus, Avatar, type AvatarProps, type AvatarSize, Badge, type BadgeProps, type BadgeVariant, BranchNavigator, type BranchNavigatorProps, BrandIcon, type BrandIconProps, type BrandIconSize, type BrandIconVariant, Breadcrumb, BreadcrumbItem, type BreadcrumbItemProps, BreadcrumbLink, type BreadcrumbLinkProps, type BreadcrumbProps, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Card, type CardBodyProps, type CardFooterProps, type CardHeaderProps, type CardMediaProps, type CardProps, type CardVariant, ChatInput, type ChatInputPosition, type ChatInputProps, ChatInterface, type ChatInterfaceProps, type ChatMessage, ChatView, type ChatViewItem, type ChatViewProps, Checkbox, type CheckboxProps, Col, type ColOffset, type ColOrder, type ColProps, type ColSpan, CollapsedSidebarToggle, type CollapsedSidebarToggleProps, ColorSwatch, type ColorSwatchProps, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerProps, type ContainerSize, type Conversation, ConversationSidebar, type ConversationSidebarProps, type ConversationTree, Divider, type DividerProps, Drawer, type DrawerPosition, type DrawerProps, FileChip, type FileChipProps, type FileChipStatus, HelperText, type HelperTextProps, ImageCard, type ImageCardProps, Input, type InputAddonProps, type InputElementProps, InputGroup, type InputGroupProps, InputLeftAddon, InputLeftElement, type InputProps, InputRightAddon, InputRightElement, InputWrapper, type InputWrapperProps, Label, type LabelProps, List, ListItem, type ListItemProps, ListItemText, type ListItemTextProps, type ListProps, ListSubheader, type ListSubheaderProps, MarkdownContent, type MarkdownContentProps, Menu, MenuContent, type MenuContentProps, MenuItem, type MenuItemProps, MenuLabel, type MenuProps, MenuSeparator, MenuTrigger, type MenuTriggerProps, Message, MessageActions, type MessageActionsConfig, type MessageActionsProps, type MessageActionsVariant, type MessageBranchInfo, type MessageNode, type MessageProps, type MessageVariant, Modal, type ModalProps, Navbar, NavbarBrand, type NavbarBrandProps, NavbarContent, type NavbarContentProps, NavbarDivider, NavbarItem, type NavbarItemProps, NavbarLink, type NavbarLinkProps, type NavbarProps, Pagination, type PaginationProps, Popover, type PopoverAlign, type PopoverPosition, type PopoverProps, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, Radio, type RadioProps, Row, type RowAlign, type RowGutter, type RowJustify, type RowProps, SectionHeading, type SectionHeadingLevel, type SectionHeadingProps, Select, type SelectOption, type SelectProps, Skeleton, type SkeletonProps, Slider, type SliderProps, Spinner, type SpinnerProps, Stack, type StackDirection, type StackGap, type StackProps, type Step, type StepStatus, Stepper, type StepperProps, StreamingCursor, type StreamingCursorProps, Switch, type SwitchProps, Tab, TabList, type TabListProps, TabPanel, type TabPanelProps, type TabProps, Table, TableBody, type TableBodyProps, TableCaption, type TableCaptionProps, TableCell, type TableCellProps, TableFooter, type TableFooterProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableRowProps, Tabs, type TabsProps, Textarea, type TextareaProps, ThinkingIndicator, type ThinkingIndicatorProps, type ToastData, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, Tooltip, type TooltipProps, type UseArtifactsReturn, type UseScrollAnchorOptions, type UseScrollAnchorReturn, type VideoAspectRatio, type VideoAspectRatioPreset, VideoCard, type VideoCardProps, addMessageToTree, createEmptyTree, createPreviewUrl, generateId, getActivePathMessages, getSiblingInfo, isBranchPoint, isImageFile, messagesToTree, revokePreviewUrl, switchBranch, updateNodeContent, useArtifacts, useScrollAnchor, useToast, version };
+export { Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, type Artifact, type ArtifactType, ArtifactsPanel, type ArtifactsPanelProps, ArtifactsPanelToggle, type ArtifactsPanelToggleProps, type AspectRatio, type AspectRatioPreset, type Attachment, type AttachmentItem, AttachmentPreview, type AttachmentPreviewProps, type AttachmentStatus, Avatar, type AvatarProps, type AvatarSize, Badge, type BadgeProps, type BadgeVariant, BranchNavigator, type BranchNavigatorProps, BrandIcon, type BrandIconProps, type BrandIconSize, type BrandIconVariant, Breadcrumb, BreadcrumbItem, type BreadcrumbItemProps, BreadcrumbLink, type BreadcrumbLinkProps, type BreadcrumbProps, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Card, type CardBodyProps, type CardFooterProps, type CardHeaderProps, type CardMediaProps, type CardProps, type CardVariant, ChatInput, type ChatInputPosition, type ChatInputProps, ChatInterface, type ChatInterfaceProps, type ChatMessage, ChatView, type ChatViewItem, type ChatViewProps, Checkbox, type CheckboxProps, Col, type ColOffset, type ColOrder, type ColProps, type ColSpan, CollapsedSidebarToggle, type CollapsedSidebarToggleProps, ColorSwatch, type ColorSwatchProps, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerProps, type ContainerSize, type Conversation, ConversationSidebar, type ConversationSidebarProps, type ConversationTree, Divider, type DividerProps, Drawer, type DrawerPosition, type DrawerProps, FileChip, type FileChipProps, type FileChipStatus, HelperText, type HelperTextProps, ImageCard, type ImageCardProps, Input, type InputAddonProps, type InputElementProps, InputGroup, type InputGroupProps, InputLeftAddon, InputLeftElement, type InputProps, InputRightAddon, InputRightElement, InputWrapper, type InputWrapperProps, Label, type LabelProps, List, ListItem, type ListItemProps, ListItemText, type ListItemTextProps, type ListProps, ListSubheader, type ListSubheaderProps, MarkdownContent, type MarkdownContentProps, Menu, MenuContent, type MenuContentProps, MenuItem, type MenuItemProps, MenuLabel, type MenuProps, MenuSeparator, MenuTrigger, type MenuTriggerProps, Message, MessageActions, type MessageActionsConfig, type MessageActionsProps, type MessageActionsVariant, type MessageBranchInfo, type MessageNode, type MessageProps, type MessageVariant, Modal, type ModalProps, Navbar, NavbarBrand, type NavbarBrandProps, NavbarContent, type NavbarContentProps, NavbarDivider, NavbarItem, type NavbarItemProps, NavbarLink, type NavbarLinkProps, type NavbarProps, Pagination, type PaginationProps, Popover, type PopoverAlign, type PopoverPosition, type PopoverProps, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, Radio, type RadioProps, Row, type RowAlign, type RowGutter, type RowJustify, type RowProps, SectionHeading, type SectionHeadingLevel, type SectionHeadingProps, Select, type SelectOption, type SelectProps, Skeleton, type SkeletonProps, Slider, type SliderProps, Spinner, type SpinnerProps, Stack, type StackDirection, type StackGap, type StackProps, type Step, type StepStatus, Stepper, type StepperProps, StreamingCursor, type StreamingCursorProps, Switch, type SwitchProps, Tab, TabList, type TabListProps, TabPanel, type TabPanelProps, type TabProps, Table, TableBody, type TableBodyProps, TableCaption, type TableCaptionProps, TableCell, type TableCellProps, TableFooter, type TableFooterProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableRowProps, Tabs, type TabsProps, Textarea, type TextareaProps, ThinkingIndicator, type ThinkingIndicatorProps, type ToastData, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, Tooltip, type TooltipProps, type UseArtifactsReturn, type UseScrollAnchorOptions, type UseScrollAnchorReturn, type VideoAspectRatio, type VideoAspectRatioPreset, VideoCard, type VideoCardProps, addMessageToTree, createEmptyTree, createPreviewUrl, generateId, getActivePathMessages, getSiblingInfo, isBranchPoint, isImageFile, messagesToTree, revokePreviewUrl, switchBranch, updateNodeContent, useArtifacts, useResizable, useScrollAnchor, useToast, version };