@lukeashford/aurelius 4.10.1 → 4.11.0

package/dist/index.d.mts

@@ -536,6 +536,53 @@ interface ProgressProps extends React$1.HTMLAttributes<HTMLDivElement> {
 }
 declare const Progress: React$1.ForwardRefExoticComponent<ProgressProps & React$1.RefAttributes<HTMLDivElement>>;
 
+type BusyOverlayTone = 'dim' | 'frost';
+type BusyOverlayBlurStrength = 'sm' | 'md' | 'lg';
+interface BusyOverlayProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Optional content rendered next to the spinner — typically a short label
+     * like "Loading session…". Pass any ReactNode so callers can compose icons,
+     * countdowns, or even nested links if needed.
+     */
+    label?: React$1.ReactNode;
+    /**
+     * Backdrop blur strength. `sm` is the default and reads as "this region is
+     * busy, the scene behind is still legible". Use `md` or `lg` only when you
+     * deliberately want to discourage the user from interacting with the
+     * region behind — e.g. a destructive retry-in-flight.
+     * @default 'sm'
+     */
+    blurStrength?: BusyOverlayBlurStrength;
+    /**
+     * Visual weight of the overlay tint.
+     *
+     * - `dim` (default) — translucent dark wash, lighter on the eyes,
+     *   communicates "this area is temporarily busy".
+     * - `frost` — heavier wash + blur, communicates "blocking-modal feel"
+     *   suitable for in-flight retries where the user shouldn't keep
+     *   reading the dimmed content.
+     *
+     * @default 'dim'
+     */
+    tone?: BusyOverlayTone;
+}
+/**
+ * Centered busy indicator that mounts `position: absolute inset-0` over its
+ * positioned parent. Use it when a known region is *temporarily unavailable
+ * but its surrounding chrome still matters* — chat tree mid-load, retry
+ * in-flight, "reconnecting" hops. Prefer `Skeleton` for data-shaped regions
+ * where the layout is known and you can preview content shape; prefer the
+ * `ChatInputNotice` slot when the unavailability is on a control rather
+ * than a region.
+ *
+ * The host must establish a positioning context (`relative`, `absolute`, or
+ * `fixed`) — `BusyOverlay` does not create its own.
+ */
+declare function BusyOverlay({ label, blurStrength, tone, className, ...rest }: BusyOverlayProps): React$1.JSX.Element;
+declare namespace BusyOverlay {
+    var displayName: string;
+}
+
 type ToastVariant = 'default' | 'success' | 'error' | 'warning' | 'info';
 type ToastPosition = 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left' | 'top-center' | 'bottom-center';
 interface ToastData {
@@ -1148,18 +1195,25 @@ declare function revokePreviewUrl(url: string | undefined): void;
  */
 declare function generateId(): string;
 
+type ChatInputNoticeVariant = 'info' | 'warning' | 'error';
 interface ChatInputNotice {
     /**
-     * Visual severity: 'warning' shows a dismissible amber notice, 'error' shows a persistent red
-     * notice
+     * Visual severity. `info` is muted neutral (slate) and non-dismissible by
+     * default — use it for transient "control unavailable" states like draft
+     * hydration or backend reconnects. `warning` is amber and dismissible by
+     * default — use it for soft-limit warnings the user can still act past.
+     * `error` is red and non-dismissible by default — use it for hard-block
+     * states like credit exhaustion.
      */
-    variant: 'warning' | 'error';
+    variant: ChatInputNoticeVariant;
     /**
-     * Content to render — plain text or any React node (e.g. text + button for error state)
+     * Content to render — plain text or any React node (e.g. text + button for
+     * error state, or a `<Spinner/>` + label for info).
      */
     content: React$1.ReactNode;
     /**
-     * Whether to show a dismiss (×) button. Defaults to true for warning, ignored for error.
+     * Whether to show a dismiss (×) button. Defaults to true for `warning`,
+     * false for `info` and `error`. Override either way explicitly.
      */
     dismissible?: boolean;
     /**
@@ -2135,6 +2189,33 @@ interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>
      * Arrow / Enter / Escape while an autocomplete panel is open.
      */
     onTextareaKeyDown?: (e: React$1.KeyboardEvent<HTMLTextAreaElement>) => void;
+    /**
+     * When true, the messages region renders a `BusyOverlay` over its content
+     * — use it while the chat tree for the current session is still loading.
+     * The surrounding chrome (sidebars, input, tool panels, header) stays
+     * mounted, so the user keeps every other affordance during the transition
+     * and the input can still surface its own notice (e.g. "Loading your
+     * draft…").
+     */
+    chatLoading?: boolean;
+    /**
+     * Forwarded to the internal `ArtifactsPanel`'s `loading` prop, which
+     * renders aurelius's existing artifact skeletons. Use it during cold-start
+     * or while the artifact snapshot is retrying — the panel chrome stays
+     * mounted and the skeletons stand in for the unknown nodes.
+     */
+    artifactsLoading?: boolean;
+    /**
+     * Forwarded to the chat-input's `disabled` prop. Pair with `inputNotice`
+     * to gate the input on consumer-owned conditions (credit exhaustion,
+     * draft hydrating, hypocaust unreachable) without blocking the rest of
+     * the surface. ChatInput stays domain-agnostic; consumers compute the
+     * `{disabled, notice}` pair and ChatInterface forwards both.
+     *
+     * OR-merged with the streaming-driven internal disable, so consumer
+     * disable doesn't accidentally re-enable an input that's mid-stream.
+     */
+    inputDisabled?: boolean;
 }
 /**
  * ChatInterface is the main orchestrator for a full-featured chat experience.
@@ -2323,9 +2404,14 @@ interface ArtifactsPanelProps extends React$1.HTMLAttributes<HTMLDivElement> {
      */
     nodes?: ArtifactNode[];
     /**
-     * Whether artifacts are still loading (show skeletons)
+     * Loading signal for the panel. Pass `true` for the cold-start case — the
+     * panel renders placeholder skeleton cards in place of real artifacts so
+     * the user sees "stuff is on its way" instead of an empty grid. Pass a
+     * `CardSlotLoading` config to skeletonise specific slots on existing
+     * cards (e.g. while a single artifact's media is hydrating). Falsy ⇒
+     * render real content.
      */
-    loading?: CardSlotLoading;
+    loading?: boolean | CardSlotLoading;
     /**
      * When set to a non-null id, surfaces the same expanded artifact card the
      * panel grid would. Drives chip click-through from outside the panel.
@@ -2879,4 +2965,4 @@ declare function getTextareaCaretCoords(textarea: HTMLTextAreaElement): Textarea
 
 declare const version = "2.0.0";
 
-export { ARTIFACT_TYPES, Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, type AddNodeOptions, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, type Artifact, ArtifactCard, type ArtifactCardProps, ArtifactGroup, type ArtifactGroupProps, ArtifactImageGridSection, type ArtifactImageGridSectionProps, type ArtifactNode, ArtifactSpotlightSection, type ArtifactSpotlightSectionProps, type ArtifactType, ArtifactVariantStack, type ArtifactVariantStackProps, ArtifactsPanel, type ArtifactsPanelProps, ArtifactsPanelToggle, type ArtifactsPanelToggleProps, type AspectRatio, type AspectRatioPreset, type Attachment, type AttachmentItem, AttachmentPreview, type AttachmentPreviewProps, type AttachmentStatus, AudioCard, type AudioCardProps, Avatar, type AvatarProps, type AvatarSize, Badge, type BadgeProps, type BadgeVariant, BranchNavigator, type BranchNavigatorProps, BrandIcon, type BrandIconProps, type BrandIconSize, type BrandIconVariant, Breadcrumb, type BreadcrumbEntry, 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, ChatBubbleIcon, ChatInput, type ChatInputNotice, type ChatInputPosition, type ChatInputProps, ChatInterface, type ChatInterfaceHandle, type ChatInterfaceProps, type ChatNode, ChatView, type ChatViewCheckpointItem, type ChatViewDividerItem, type ChatViewItem, type ChatViewMessageItem, type ChatViewProps, CheckSquareIcon, Checkbox, type CheckboxProps, Checkpoint, type CheckpointBranchInfo, type CheckpointExecutionKind, type CheckpointNode, type CheckpointProps, type CheckpointStatus, ChevronLeftIcon, ChevronRightIcon, CloseIcon, Col, type ColOffset, type ColOrder, type ColProps, type ColSpan, ColorPaletteSection, type ColorPaletteSectionProps, ColorSwatch, type ColorSwatchProps, Combobox, type ComboboxNav, type ComboboxProps, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerProps, type ContainerSize, type Conversation, type ConversationTree, CoverSection, type CoverSectionProps, CrossSquareIcon, type Deliverable, type DeliverableArtifactRef, DeliverableCard, type DeliverableCardProps, type DeliverableImageItem, DeliverableRenderer, type DeliverableRendererProps, type DeliverableSection, type DeliverableSwatch, type DeliverableTheme, Divider, type DividerProps, Drawer, type DrawerPosition, type DrawerProps, EmptySquareIcon, ExpandIcon, type ExternalToolDefinition, FileChip, type FileChipProps, type FileChipStatus, GreyedDivider, type GreyedDividerProps, HelperText, type HelperTextProps, HistoryIcon, HistoryPanel, type HistoryPanelProps, type IconProps, ImageCard, type ImageCardProps, type ImageGridAspectRatio, Input, type InputAddonProps, type InputElementProps, InputGroup, type InputGroupProps, InputLeftAddon, InputLeftElement, type InputProps, InputRightAddon, InputRightElement, InputWrapper, type InputWrapperProps, Label, type LabelProps, LayersIcon, Lightbox, type LightboxProps, List, ListItem, type ListItemProps, ListItemText, type ListItemTextProps, type ListProps, ListSubheader, type ListSubheaderProps, MarkdownContent, type MarkdownContentProps, MediaIcon, MentionChip, type MentionChipProps, 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, NODE_TYPES, Navbar, NavbarBrand, type NavbarBrandProps, NavbarContent, type NavbarContentProps, NavbarDivider, NavbarItem, type NavbarItemProps, NavbarLink, type NavbarLinkProps, type NavbarProps, type NodeTopology, type NodeType, Pagination, type PaginationProps, PdfCard, type PdfCardProps, PlusIcon, Popover, type PopoverAlign, type PopoverPosition, type PopoverProps, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, QuoteBlockSection, type QuoteBlockSectionProps, Radio, type RadioProps, Row, type RowAlign, type RowGutter, type RowJustify, type RowProps, SCRIPT_ELEMENT_TYPES, ScriptCard, type ScriptCardProps, type ScriptElement, type ScriptElementType, SectionHeading, type SectionHeadingLevel, type SectionHeadingProps, Select, type SelectOption, type SelectProps, Skeleton, type SkeletonProps, Slider, type SliderProps, Spinner, type SpinnerProps, type SpotlightVariant, SquareLoaderIcon, Stack, type StackDirection, type StackGap, type StackProps, type Step, type StepStatus, Stepper, type StepperProps, StreamingCursor, type StreamingCursorProps, Switch, type SwitchProps, TASK_STATUSES, 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, type Task, type TaskStatus, TextBlockSection, type TextBlockSectionProps, TextCard, type TextCardProps, Textarea, type TextareaCaretCoords, type TextareaProps, ThinkingIndicator, type ThinkingIndicatorProps, type ToastData, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, TodosList, type TodosListProps, type ToolDefinition, type ToolGroup, ToolPanelContainer, type ToolPanelContainerProps, type ToolPanelState, ToolSidebar, type ToolSidebarProps, Tooltip, type TooltipProps, type TreeNode, type UseArtifactTreeNavigationReturn, type UseComboboxNavOptions, type UseScrollAnchorOptions, type UseScrollAnchorReturn, type VideoAspectRatio, type VideoAspectRatioPreset, VideoCard, type VideoCardProps, addNodeToTree, areAllTasksSettled, createEmptyTree, createPreviewUrl, findAncestor, generateId, getActivePath, getGreyedFuture, getSiblingInfo, getTextareaCaretCoords, isBranchPoint, isImageFile, messagesToTree, revokePreviewUrl, setActiveLeaf, switchBranch, updateMessageContent, useArtifactTreeNavigation, useComboboxNav, useResizable, useScrollAnchor, useToast, version };
+export { ARTIFACT_TYPES, Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, type AddNodeOptions, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, type Artifact, ArtifactCard, type ArtifactCardProps, ArtifactGroup, type ArtifactGroupProps, ArtifactImageGridSection, type ArtifactImageGridSectionProps, type ArtifactNode, ArtifactSpotlightSection, type ArtifactSpotlightSectionProps, type ArtifactType, ArtifactVariantStack, type ArtifactVariantStackProps, ArtifactsPanel, type ArtifactsPanelProps, ArtifactsPanelToggle, type ArtifactsPanelToggleProps, type AspectRatio, type AspectRatioPreset, type Attachment, type AttachmentItem, AttachmentPreview, type AttachmentPreviewProps, type AttachmentStatus, AudioCard, type AudioCardProps, Avatar, type AvatarProps, type AvatarSize, Badge, type BadgeProps, type BadgeVariant, BranchNavigator, type BranchNavigatorProps, BrandIcon, type BrandIconProps, type BrandIconSize, type BrandIconVariant, Breadcrumb, type BreadcrumbEntry, BreadcrumbItem, type BreadcrumbItemProps, BreadcrumbLink, type BreadcrumbLinkProps, type BreadcrumbProps, BusyOverlay, type BusyOverlayBlurStrength, type BusyOverlayProps, type BusyOverlayTone, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Card, type CardBodyProps, type CardFooterProps, type CardHeaderProps, type CardMediaProps, type CardProps, type CardVariant, ChatBubbleIcon, ChatInput, type ChatInputNotice, type ChatInputNoticeVariant, type ChatInputPosition, type ChatInputProps, ChatInterface, type ChatInterfaceHandle, type ChatInterfaceProps, type ChatNode, ChatView, type ChatViewCheckpointItem, type ChatViewDividerItem, type ChatViewItem, type ChatViewMessageItem, type ChatViewProps, CheckSquareIcon, Checkbox, type CheckboxProps, Checkpoint, type CheckpointBranchInfo, type CheckpointExecutionKind, type CheckpointNode, type CheckpointProps, type CheckpointStatus, ChevronLeftIcon, ChevronRightIcon, CloseIcon, Col, type ColOffset, type ColOrder, type ColProps, type ColSpan, ColorPaletteSection, type ColorPaletteSectionProps, ColorSwatch, type ColorSwatchProps, Combobox, type ComboboxNav, type ComboboxProps, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerProps, type ContainerSize, type Conversation, type ConversationTree, CoverSection, type CoverSectionProps, CrossSquareIcon, type Deliverable, type DeliverableArtifactRef, DeliverableCard, type DeliverableCardProps, type DeliverableImageItem, DeliverableRenderer, type DeliverableRendererProps, type DeliverableSection, type DeliverableSwatch, type DeliverableTheme, Divider, type DividerProps, Drawer, type DrawerPosition, type DrawerProps, EmptySquareIcon, ExpandIcon, type ExternalToolDefinition, FileChip, type FileChipProps, type FileChipStatus, GreyedDivider, type GreyedDividerProps, HelperText, type HelperTextProps, HistoryIcon, HistoryPanel, type HistoryPanelProps, type IconProps, ImageCard, type ImageCardProps, type ImageGridAspectRatio, Input, type InputAddonProps, type InputElementProps, InputGroup, type InputGroupProps, InputLeftAddon, InputLeftElement, type InputProps, InputRightAddon, InputRightElement, InputWrapper, type InputWrapperProps, Label, type LabelProps, LayersIcon, Lightbox, type LightboxProps, List, ListItem, type ListItemProps, ListItemText, type ListItemTextProps, type ListProps, ListSubheader, type ListSubheaderProps, MarkdownContent, type MarkdownContentProps, MediaIcon, MentionChip, type MentionChipProps, 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, NODE_TYPES, Navbar, NavbarBrand, type NavbarBrandProps, NavbarContent, type NavbarContentProps, NavbarDivider, NavbarItem, type NavbarItemProps, NavbarLink, type NavbarLinkProps, type NavbarProps, type NodeTopology, type NodeType, Pagination, type PaginationProps, PdfCard, type PdfCardProps, PlusIcon, Popover, type PopoverAlign, type PopoverPosition, type PopoverProps, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, QuoteBlockSection, type QuoteBlockSectionProps, Radio, type RadioProps, Row, type RowAlign, type RowGutter, type RowJustify, type RowProps, SCRIPT_ELEMENT_TYPES, ScriptCard, type ScriptCardProps, type ScriptElement, type ScriptElementType, SectionHeading, type SectionHeadingLevel, type SectionHeadingProps, Select, type SelectOption, type SelectProps, Skeleton, type SkeletonProps, Slider, type SliderProps, Spinner, type SpinnerProps, type SpotlightVariant, SquareLoaderIcon, Stack, type StackDirection, type StackGap, type StackProps, type Step, type StepStatus, Stepper, type StepperProps, StreamingCursor, type StreamingCursorProps, Switch, type SwitchProps, TASK_STATUSES, 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, type Task, type TaskStatus, TextBlockSection, type TextBlockSectionProps, TextCard, type TextCardProps, Textarea, type TextareaCaretCoords, type TextareaProps, ThinkingIndicator, type ThinkingIndicatorProps, type ToastData, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, TodosList, type TodosListProps, type ToolDefinition, type ToolGroup, ToolPanelContainer, type ToolPanelContainerProps, type ToolPanelState, ToolSidebar, type ToolSidebarProps, Tooltip, type TooltipProps, type TreeNode, type UseArtifactTreeNavigationReturn, type UseComboboxNavOptions, type UseScrollAnchorOptions, type UseScrollAnchorReturn, type VideoAspectRatio, type VideoAspectRatioPreset, VideoCard, type VideoCardProps, addNodeToTree, areAllTasksSettled, createEmptyTree, createPreviewUrl, findAncestor, generateId, getActivePath, getGreyedFuture, getSiblingInfo, getTextareaCaretCoords, isBranchPoint, isImageFile, messagesToTree, revokePreviewUrl, setActiveLeaf, switchBranch, updateMessageContent, useArtifactTreeNavigation, useComboboxNav, useResizable, useScrollAnchor, useToast, version };

package/dist/index.d.ts

@@ -536,6 +536,53 @@ interface ProgressProps extends React$1.HTMLAttributes<HTMLDivElement> {
 }
 declare const Progress: React$1.ForwardRefExoticComponent<ProgressProps & React$1.RefAttributes<HTMLDivElement>>;
 
+type BusyOverlayTone = 'dim' | 'frost';
+type BusyOverlayBlurStrength = 'sm' | 'md' | 'lg';
+interface BusyOverlayProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Optional content rendered next to the spinner — typically a short label
+     * like "Loading session…". Pass any ReactNode so callers can compose icons,
+     * countdowns, or even nested links if needed.
+     */
+    label?: React$1.ReactNode;
+    /**
+     * Backdrop blur strength. `sm` is the default and reads as "this region is
+     * busy, the scene behind is still legible". Use `md` or `lg` only when you
+     * deliberately want to discourage the user from interacting with the
+     * region behind — e.g. a destructive retry-in-flight.
+     * @default 'sm'
+     */
+    blurStrength?: BusyOverlayBlurStrength;
+    /**
+     * Visual weight of the overlay tint.
+     *
+     * - `dim` (default) — translucent dark wash, lighter on the eyes,
+     *   communicates "this area is temporarily busy".
+     * - `frost` — heavier wash + blur, communicates "blocking-modal feel"
+     *   suitable for in-flight retries where the user shouldn't keep
+     *   reading the dimmed content.
+     *
+     * @default 'dim'
+     */
+    tone?: BusyOverlayTone;
+}
+/**
+ * Centered busy indicator that mounts `position: absolute inset-0` over its
+ * positioned parent. Use it when a known region is *temporarily unavailable
+ * but its surrounding chrome still matters* — chat tree mid-load, retry
+ * in-flight, "reconnecting" hops. Prefer `Skeleton` for data-shaped regions
+ * where the layout is known and you can preview content shape; prefer the
+ * `ChatInputNotice` slot when the unavailability is on a control rather
+ * than a region.
+ *
+ * The host must establish a positioning context (`relative`, `absolute`, or
+ * `fixed`) — `BusyOverlay` does not create its own.
+ */
+declare function BusyOverlay({ label, blurStrength, tone, className, ...rest }: BusyOverlayProps): React$1.JSX.Element;
+declare namespace BusyOverlay {
+    var displayName: string;
+}
+
 type ToastVariant = 'default' | 'success' | 'error' | 'warning' | 'info';
 type ToastPosition = 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left' | 'top-center' | 'bottom-center';
 interface ToastData {
@@ -1148,18 +1195,25 @@ declare function revokePreviewUrl(url: string | undefined): void;
  */
 declare function generateId(): string;
 
+type ChatInputNoticeVariant = 'info' | 'warning' | 'error';
 interface ChatInputNotice {
     /**
-     * Visual severity: 'warning' shows a dismissible amber notice, 'error' shows a persistent red
-     * notice
+     * Visual severity. `info` is muted neutral (slate) and non-dismissible by
+     * default — use it for transient "control unavailable" states like draft
+     * hydration or backend reconnects. `warning` is amber and dismissible by
+     * default — use it for soft-limit warnings the user can still act past.
+     * `error` is red and non-dismissible by default — use it for hard-block
+     * states like credit exhaustion.
      */
-    variant: 'warning' | 'error';
+    variant: ChatInputNoticeVariant;
     /**
-     * Content to render — plain text or any React node (e.g. text + button for error state)
+     * Content to render — plain text or any React node (e.g. text + button for
+     * error state, or a `<Spinner/>` + label for info).
      */
     content: React$1.ReactNode;
     /**
-     * Whether to show a dismiss (×) button. Defaults to true for warning, ignored for error.
+     * Whether to show a dismiss (×) button. Defaults to true for `warning`,
+     * false for `info` and `error`. Override either way explicitly.
      */
     dismissible?: boolean;
     /**
@@ -2135,6 +2189,33 @@ interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>
      * Arrow / Enter / Escape while an autocomplete panel is open.
      */
     onTextareaKeyDown?: (e: React$1.KeyboardEvent<HTMLTextAreaElement>) => void;
+    /**
+     * When true, the messages region renders a `BusyOverlay` over its content
+     * — use it while the chat tree for the current session is still loading.
+     * The surrounding chrome (sidebars, input, tool panels, header) stays
+     * mounted, so the user keeps every other affordance during the transition
+     * and the input can still surface its own notice (e.g. "Loading your
+     * draft…").
+     */
+    chatLoading?: boolean;
+    /**
+     * Forwarded to the internal `ArtifactsPanel`'s `loading` prop, which
+     * renders aurelius's existing artifact skeletons. Use it during cold-start
+     * or while the artifact snapshot is retrying — the panel chrome stays
+     * mounted and the skeletons stand in for the unknown nodes.
+     */
+    artifactsLoading?: boolean;
+    /**
+     * Forwarded to the chat-input's `disabled` prop. Pair with `inputNotice`
+     * to gate the input on consumer-owned conditions (credit exhaustion,
+     * draft hydrating, hypocaust unreachable) without blocking the rest of
+     * the surface. ChatInput stays domain-agnostic; consumers compute the
+     * `{disabled, notice}` pair and ChatInterface forwards both.
+     *
+     * OR-merged with the streaming-driven internal disable, so consumer
+     * disable doesn't accidentally re-enable an input that's mid-stream.
+     */
+    inputDisabled?: boolean;
 }
 /**
  * ChatInterface is the main orchestrator for a full-featured chat experience.
@@ -2323,9 +2404,14 @@ interface ArtifactsPanelProps extends React$1.HTMLAttributes<HTMLDivElement> {
      */
     nodes?: ArtifactNode[];
     /**
-     * Whether artifacts are still loading (show skeletons)
+     * Loading signal for the panel. Pass `true` for the cold-start case — the
+     * panel renders placeholder skeleton cards in place of real artifacts so
+     * the user sees "stuff is on its way" instead of an empty grid. Pass a
+     * `CardSlotLoading` config to skeletonise specific slots on existing
+     * cards (e.g. while a single artifact's media is hydrating). Falsy ⇒
+     * render real content.
      */
-    loading?: CardSlotLoading;
+    loading?: boolean | CardSlotLoading;
     /**
      * When set to a non-null id, surfaces the same expanded artifact card the
      * panel grid would. Drives chip click-through from outside the panel.
@@ -2879,4 +2965,4 @@ declare function getTextareaCaretCoords(textarea: HTMLTextAreaElement): Textarea
 
 declare const version = "2.0.0";
 
-export { ARTIFACT_TYPES, Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, type AddNodeOptions, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, type Artifact, ArtifactCard, type ArtifactCardProps, ArtifactGroup, type ArtifactGroupProps, ArtifactImageGridSection, type ArtifactImageGridSectionProps, type ArtifactNode, ArtifactSpotlightSection, type ArtifactSpotlightSectionProps, type ArtifactType, ArtifactVariantStack, type ArtifactVariantStackProps, ArtifactsPanel, type ArtifactsPanelProps, ArtifactsPanelToggle, type ArtifactsPanelToggleProps, type AspectRatio, type AspectRatioPreset, type Attachment, type AttachmentItem, AttachmentPreview, type AttachmentPreviewProps, type AttachmentStatus, AudioCard, type AudioCardProps, Avatar, type AvatarProps, type AvatarSize, Badge, type BadgeProps, type BadgeVariant, BranchNavigator, type BranchNavigatorProps, BrandIcon, type BrandIconProps, type BrandIconSize, type BrandIconVariant, Breadcrumb, type BreadcrumbEntry, 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, ChatBubbleIcon, ChatInput, type ChatInputNotice, type ChatInputPosition, type ChatInputProps, ChatInterface, type ChatInterfaceHandle, type ChatInterfaceProps, type ChatNode, ChatView, type ChatViewCheckpointItem, type ChatViewDividerItem, type ChatViewItem, type ChatViewMessageItem, type ChatViewProps, CheckSquareIcon, Checkbox, type CheckboxProps, Checkpoint, type CheckpointBranchInfo, type CheckpointExecutionKind, type CheckpointNode, type CheckpointProps, type CheckpointStatus, ChevronLeftIcon, ChevronRightIcon, CloseIcon, Col, type ColOffset, type ColOrder, type ColProps, type ColSpan, ColorPaletteSection, type ColorPaletteSectionProps, ColorSwatch, type ColorSwatchProps, Combobox, type ComboboxNav, type ComboboxProps, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerProps, type ContainerSize, type Conversation, type ConversationTree, CoverSection, type CoverSectionProps, CrossSquareIcon, type Deliverable, type DeliverableArtifactRef, DeliverableCard, type DeliverableCardProps, type DeliverableImageItem, DeliverableRenderer, type DeliverableRendererProps, type DeliverableSection, type DeliverableSwatch, type DeliverableTheme, Divider, type DividerProps, Drawer, type DrawerPosition, type DrawerProps, EmptySquareIcon, ExpandIcon, type ExternalToolDefinition, FileChip, type FileChipProps, type FileChipStatus, GreyedDivider, type GreyedDividerProps, HelperText, type HelperTextProps, HistoryIcon, HistoryPanel, type HistoryPanelProps, type IconProps, ImageCard, type ImageCardProps, type ImageGridAspectRatio, Input, type InputAddonProps, type InputElementProps, InputGroup, type InputGroupProps, InputLeftAddon, InputLeftElement, type InputProps, InputRightAddon, InputRightElement, InputWrapper, type InputWrapperProps, Label, type LabelProps, LayersIcon, Lightbox, type LightboxProps, List, ListItem, type ListItemProps, ListItemText, type ListItemTextProps, type ListProps, ListSubheader, type ListSubheaderProps, MarkdownContent, type MarkdownContentProps, MediaIcon, MentionChip, type MentionChipProps, 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, NODE_TYPES, Navbar, NavbarBrand, type NavbarBrandProps, NavbarContent, type NavbarContentProps, NavbarDivider, NavbarItem, type NavbarItemProps, NavbarLink, type NavbarLinkProps, type NavbarProps, type NodeTopology, type NodeType, Pagination, type PaginationProps, PdfCard, type PdfCardProps, PlusIcon, Popover, type PopoverAlign, type PopoverPosition, type PopoverProps, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, QuoteBlockSection, type QuoteBlockSectionProps, Radio, type RadioProps, Row, type RowAlign, type RowGutter, type RowJustify, type RowProps, SCRIPT_ELEMENT_TYPES, ScriptCard, type ScriptCardProps, type ScriptElement, type ScriptElementType, SectionHeading, type SectionHeadingLevel, type SectionHeadingProps, Select, type SelectOption, type SelectProps, Skeleton, type SkeletonProps, Slider, type SliderProps, Spinner, type SpinnerProps, type SpotlightVariant, SquareLoaderIcon, Stack, type StackDirection, type StackGap, type StackProps, type Step, type StepStatus, Stepper, type StepperProps, StreamingCursor, type StreamingCursorProps, Switch, type SwitchProps, TASK_STATUSES, 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, type Task, type TaskStatus, TextBlockSection, type TextBlockSectionProps, TextCard, type TextCardProps, Textarea, type TextareaCaretCoords, type TextareaProps, ThinkingIndicator, type ThinkingIndicatorProps, type ToastData, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, TodosList, type TodosListProps, type ToolDefinition, type ToolGroup, ToolPanelContainer, type ToolPanelContainerProps, type ToolPanelState, ToolSidebar, type ToolSidebarProps, Tooltip, type TooltipProps, type TreeNode, type UseArtifactTreeNavigationReturn, type UseComboboxNavOptions, type UseScrollAnchorOptions, type UseScrollAnchorReturn, type VideoAspectRatio, type VideoAspectRatioPreset, VideoCard, type VideoCardProps, addNodeToTree, areAllTasksSettled, createEmptyTree, createPreviewUrl, findAncestor, generateId, getActivePath, getGreyedFuture, getSiblingInfo, getTextareaCaretCoords, isBranchPoint, isImageFile, messagesToTree, revokePreviewUrl, setActiveLeaf, switchBranch, updateMessageContent, useArtifactTreeNavigation, useComboboxNav, useResizable, useScrollAnchor, useToast, version };
+export { ARTIFACT_TYPES, Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, type AddNodeOptions, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, type Artifact, ArtifactCard, type ArtifactCardProps, ArtifactGroup, type ArtifactGroupProps, ArtifactImageGridSection, type ArtifactImageGridSectionProps, type ArtifactNode, ArtifactSpotlightSection, type ArtifactSpotlightSectionProps, type ArtifactType, ArtifactVariantStack, type ArtifactVariantStackProps, ArtifactsPanel, type ArtifactsPanelProps, ArtifactsPanelToggle, type ArtifactsPanelToggleProps, type AspectRatio, type AspectRatioPreset, type Attachment, type AttachmentItem, AttachmentPreview, type AttachmentPreviewProps, type AttachmentStatus, AudioCard, type AudioCardProps, Avatar, type AvatarProps, type AvatarSize, Badge, type BadgeProps, type BadgeVariant, BranchNavigator, type BranchNavigatorProps, BrandIcon, type BrandIconProps, type BrandIconSize, type BrandIconVariant, Breadcrumb, type BreadcrumbEntry, BreadcrumbItem, type BreadcrumbItemProps, BreadcrumbLink, type BreadcrumbLinkProps, type BreadcrumbProps, BusyOverlay, type BusyOverlayBlurStrength, type BusyOverlayProps, type BusyOverlayTone, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Card, type CardBodyProps, type CardFooterProps, type CardHeaderProps, type CardMediaProps, type CardProps, type CardVariant, ChatBubbleIcon, ChatInput, type ChatInputNotice, type ChatInputNoticeVariant, type ChatInputPosition, type ChatInputProps, ChatInterface, type ChatInterfaceHandle, type ChatInterfaceProps, type ChatNode, ChatView, type ChatViewCheckpointItem, type ChatViewDividerItem, type ChatViewItem, type ChatViewMessageItem, type ChatViewProps, CheckSquareIcon, Checkbox, type CheckboxProps, Checkpoint, type CheckpointBranchInfo, type CheckpointExecutionKind, type CheckpointNode, type CheckpointProps, type CheckpointStatus, ChevronLeftIcon, ChevronRightIcon, CloseIcon, Col, type ColOffset, type ColOrder, type ColProps, type ColSpan, ColorPaletteSection, type ColorPaletteSectionProps, ColorSwatch, type ColorSwatchProps, Combobox, type ComboboxNav, type ComboboxProps, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerProps, type ContainerSize, type Conversation, type ConversationTree, CoverSection, type CoverSectionProps, CrossSquareIcon, type Deliverable, type DeliverableArtifactRef, DeliverableCard, type DeliverableCardProps, type DeliverableImageItem, DeliverableRenderer, type DeliverableRendererProps, type DeliverableSection, type DeliverableSwatch, type DeliverableTheme, Divider, type DividerProps, Drawer, type DrawerPosition, type DrawerProps, EmptySquareIcon, ExpandIcon, type ExternalToolDefinition, FileChip, type FileChipProps, type FileChipStatus, GreyedDivider, type GreyedDividerProps, HelperText, type HelperTextProps, HistoryIcon, HistoryPanel, type HistoryPanelProps, type IconProps, ImageCard, type ImageCardProps, type ImageGridAspectRatio, Input, type InputAddonProps, type InputElementProps, InputGroup, type InputGroupProps, InputLeftAddon, InputLeftElement, type InputProps, InputRightAddon, InputRightElement, InputWrapper, type InputWrapperProps, Label, type LabelProps, LayersIcon, Lightbox, type LightboxProps, List, ListItem, type ListItemProps, ListItemText, type ListItemTextProps, type ListProps, ListSubheader, type ListSubheaderProps, MarkdownContent, type MarkdownContentProps, MediaIcon, MentionChip, type MentionChipProps, 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, NODE_TYPES, Navbar, NavbarBrand, type NavbarBrandProps, NavbarContent, type NavbarContentProps, NavbarDivider, NavbarItem, type NavbarItemProps, NavbarLink, type NavbarLinkProps, type NavbarProps, type NodeTopology, type NodeType, Pagination, type PaginationProps, PdfCard, type PdfCardProps, PlusIcon, Popover, type PopoverAlign, type PopoverPosition, type PopoverProps, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, QuoteBlockSection, type QuoteBlockSectionProps, Radio, type RadioProps, Row, type RowAlign, type RowGutter, type RowJustify, type RowProps, SCRIPT_ELEMENT_TYPES, ScriptCard, type ScriptCardProps, type ScriptElement, type ScriptElementType, SectionHeading, type SectionHeadingLevel, type SectionHeadingProps, Select, type SelectOption, type SelectProps, Skeleton, type SkeletonProps, Slider, type SliderProps, Spinner, type SpinnerProps, type SpotlightVariant, SquareLoaderIcon, Stack, type StackDirection, type StackGap, type StackProps, type Step, type StepStatus, Stepper, type StepperProps, StreamingCursor, type StreamingCursorProps, Switch, type SwitchProps, TASK_STATUSES, 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, type Task, type TaskStatus, TextBlockSection, type TextBlockSectionProps, TextCard, type TextCardProps, Textarea, type TextareaCaretCoords, type TextareaProps, ThinkingIndicator, type ThinkingIndicatorProps, type ToastData, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, TodosList, type TodosListProps, type ToolDefinition, type ToolGroup, ToolPanelContainer, type ToolPanelContainerProps, type ToolPanelState, ToolSidebar, type ToolSidebarProps, Tooltip, type TooltipProps, type TreeNode, type UseArtifactTreeNavigationReturn, type UseComboboxNavOptions, type UseScrollAnchorOptions, type UseScrollAnchorReturn, type VideoAspectRatio, type VideoAspectRatioPreset, VideoCard, type VideoCardProps, addNodeToTree, areAllTasksSettled, createEmptyTree, createPreviewUrl, findAncestor, generateId, getActivePath, getGreyedFuture, getSiblingInfo, getTextareaCaretCoords, isBranchPoint, isImageFile, messagesToTree, revokePreviewUrl, setActiveLeaf, switchBranch, updateMessageContent, useArtifactTreeNavigation, useComboboxNav, useResizable, useScrollAnchor, useToast, version };