@lukeashford/aurelius 3.4.0 → 3.6.0

package/llms.md

@@ -155,13 +155,14 @@ Import from `@lukeashford/aurelius`:
 | VideoCard | src, title, subtitle, aspectRatio (${number}/${number}), playing, controls, light, volume, muted, loop, mediaClassName, contentClassName, playerProps, loading |
 | ArtifactsPanel | nodes, loading, artifactCount, onExpand |
 | BranchNavigator | current, total, onPrevious, onNext, size, showIcon |
-| ChatInput | position (centered, bottom), placeholder, helperText, onSubmit, disabled, animate, isStreaming, onStop, attachments, onAttachmentsChange, showAttachmentButton, acceptedFileTypes |
-| ChatInterface | messages, conversationTree, onTreeChange, conversations, onMessageSubmit, onEditMessage, onRetryMessage, onStop, onSelectConversation, onNewChat, isStreaming, isThinking, placeholder, emptyStateHelper, emptyState, showAttachmentButton, enableMessageActions, attachments, onAttachmentsChange, artifactNodes, isArtifactsPanelOpen, onArtifactsPanelOpenChange, tasks, tasksTitle, onStopAllTasks, tools |
+| ChatInput | position (centered, bottom), placeholder, helperText, onSubmit, disabled, animate, isStreaming, onStop, attachments, onAttachmentsChange, showAttachmentButton, acceptedFileTypes, notice, onInputChange, autoFocus |
+| ChatInterface | messages, conversationTree, onTreeChange, conversations, onMessageSubmit, onEditMessage, onRetryMessage, onStop, onSelectConversation, onNewChat, onRenameConversation, isStreaming, isThinking, placeholder, emptyStateHelper, emptyState, showAttachmentButton, enableMessageActions, attachments, onAttachmentsChange, artifactNodes, isArtifactsPanelOpen, onArtifactsPanelOpenChange, tasks, tasksTitle, onStopAllTasks |
 | ChatView | messages, latestUserMessageIndex, isStreaming, isThinking, onScroll |
+| HistoryPanel | conversations, onSelectConversation, onNewChat, onRenameConversation |
 | MessageActions | variant (user, assistant), content, onEdit, onRetry, isEditing, onEditingChange, editValue |
 | ThinkingIndicator | isVisible, phraseInterval, phrases |
 | TodosList | tasks, title, onStopAllTasks |
-| ToolPanelContainer | topContent, bottomContent, width, onResizeStart, side |
+| ToolPanelContainer | topContent, bottomContent, width, initialTopPercent, onResizeStart, side |
 | ToolSidebar | tools, activeTools, onToggleTool, side |
 | ChatBubbleIcon | children |
 | CheckSquareIcon | children |
@@ -375,6 +376,10 @@ Features:
 - Streaming state with stop button
 - Animated transition between positions
 
+- **ChatInputNotice.variant**: * Visual severity: 'warning' shows a dismissible amber notice, 'error' shows a persistent red notice
+- **ChatInputNotice.content**: * Content to render — plain text or any React node (e.g. text + button for error state)
+- **ChatInputNotice.dismissible**: * Whether to show a dismiss (×) button. Defaults to true for warning, ignored for error.
+- **ChatInputNotice.onDismiss**: * Called when the dismiss button is clicked. Consumer controls whether the notice disappears.
 - **position**: * Position of the input: 'centered' for empty state, 'bottom' for conversation mode
 - **placeholder**: * Placeholder text for the input
 - **helperText**: * Helper text shown above the input in centered mode
@@ -387,6 +392,9 @@ Features:
 - **onAttachmentsChange**: * Called when attachments change (controlled mode)
 - **showAttachmentButton**: * Whether to show the attachment button
 - **acceptedFileTypes**: * Accepted file types for attachments
+- **notice**: * Optional notice displayed above the input (e.g. credit warnings or exhaustion messages)
+- **onInputChange**: * Called whenever the input value changes, giving the consumer access to the current text
+- **autoFocus**: * Whether to automatically focus the input when it becomes enabled
 
 **ChatInterface**
 ChatInterface is the main orchestrator for a full-featured chat experience.
@@ -413,6 +421,11 @@ artifactNodes prop.
 - **ChatMessage.variant**: * Whether the message is from the user or the assistant
 - **ChatMessage.content**: * Message content (Markdown supported)
 - **ChatMessage.isStreaming**: * Whether the message is currently streaming
+- **Conversation.id**: * Unique identifier for the conversation
+- **Conversation.title**: * Title shown as the first line of the row. Editable via the rename affordance.
+- **Conversation.project**: * Project this conversation belongs to. Shown as the second line of the row and collected into the project filter in the history panel.
+- **Conversation.timestamp**: * Timestamp used to group conversations into Today / Yesterday / Older. Accepts a Date, ISO string, or millisecond epoch. Not displayed.
+- **Conversation.isActive**: * Whether this conversation is currently active (highlighted in the list).
 - **messages**: * Array of messages in the conversation (flat mode) Use this OR conversationTree, not both
 - **conversationTree**: * Conversation tree for branching support Use this OR messages, not both
 - **onTreeChange**: * Called when the conversation tree changes (for tree mode)
@@ -423,6 +436,7 @@ artifactNodes prop.
 - **onStop**: * Called when the Stop button is clicked during assistant streaming.
 - **onSelectConversation**: * Called when a conversation is selected from the sidebar.
 - **onNewChat**: * Called when the "New Chat" button is clicked in the sidebar.
+- **onRenameConversation**: * Called when a conversation's title is renamed from the history panel. Receives the conversation id and the new, trimmed title.
 - **isStreaming**: * Whether the assistant is currently streaming a response. Shows a stop button and disables certain actions.
 - **isThinking**: * Whether to show the thinking indicator. Typically shown after a user message but before the first streaming token.
 - **placeholder**: * Placeholder text for the main chat input.
@@ -438,7 +452,6 @@ artifactNodes prop.
 - **tasks**: * Tasks to display in the todos list tool panel. Shows a list of tasks with status indicators.
 - **tasksTitle**: * Title for the todos list @default "Tasks"
 - **onStopAllTasks**: * Called when the "Stop All Tasks" button is clicked in the tasks panel. Only shown when at least one task has in_progress status. The consumer app decides what stopping means (cancel API calls, mark tasks cancelled, etc.). * May return a Promise. While the Promise is pending, the button becomes disabled and displays a spinner with "Stopping tasks" so the user knows the stop request is in flight.
-- **tools**: * Additional tools to add to the tool sidebars. Each ExternalToolDefinition provides an id, icon, label, group ('top-left' | 'bottom-left' | 'top-right' | 'bottom-right'), and content (ReactNode) to render when opened. Tools in the same group are mutually exclusive. Built-in tools occupy: History (top-left), Artifacts (top-right), Tasks (bottom-right). Consumer tools are added alongside these.
 
 **ChatView**
 ChatView displays a conversation thread with smart scrolling behavior.
@@ -456,6 +469,17 @@ Key behaviors:
 - **isThinking**: * Whether to show the thinking indicator (between user message and response)
 - **onScroll**: * Callback when the user scrolls manually
 
+**HistoryPanel**
+HistoryPanel renders the conversation history sidebar: a project filter,
+a "New Chat" button, and the conversation list grouped by recency
+(Today / Yesterday / Older). Each row shows the title and an optional
+project subtitle, and exposes an inline rename affordance on hover.
+
+- **conversations**: * List of past conversations to display.
+- **onSelectConversation**: * Called when a conversation is selected.
+- **onNewChat**: * Called when the "New Chat" button is clicked.
+- **onRenameConversation**: * Called when a conversation's title is edited.
+
 **MessageActions**
 - **variant**: * Whether this is for a user or assistant message
 - **content**: * The message content for copy functionality
@@ -493,6 +517,7 @@ to the previous ArtifactsPanel resize behavior.
 - **topContent**: * Content for the top tool slot (from the top group). When null, the bottom slot takes full height.
 - **bottomContent**: * Content for the bottom tool slot (from the bottom group). When null, the top slot takes full height.
 - **width**: * Panel width as CSS value (e.g., "50vw")
+- **initialTopPercent**: * Default top panel height percentage (0-100). @default 60
 - **onResizeStart**: * Callback to start horizontal resizing (width dragger)
 - **side**: * Which side this panel is on — controls border and resize handle position
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lukeashford/aurelius",
-  "version": "3.4.0",
+  "version": "3.6.0",
   "description": "Design system for Aurelius applications — A cohesive visual language for creative technologists",
   "main": "dist/index.js",
   "module": "dist/index.mjs",