@lukeashford/aurelius 4.6.0 → 4.8.0

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 import React$1, { ReactNode } from 'react';
-import { Config } from 'dompurify';
 import ReactPlayer from 'react-player';
 
 type ButtonVariant = 'primary' | 'important' | 'elevated' | 'outlined' | 'featured' | 'ghost' | 'danger';
@@ -40,6 +39,21 @@ interface CardHeaderProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, '
     title?: React$1.ReactNode;
     subtitle?: React$1.ReactNode;
     action?: React$1.ReactNode;
+    /**
+     * Optional addressable handle (the artifact's `name` / `@-handle`). Renders
+     * as a tertiary monospace line below the subtitle, prefixed with `@`. Click
+     * copies `@<handle>` to the clipboard and pulses the handle once. Use to
+     * surface the typed identifier filmmakers reference in chat.
+     */
+    handle?: string;
+}
+/**
+ * Click-to-copy `@-handle` line. Rendered automatically by `Card.Header` when
+ * its `handle` prop is set; exposed standalone as `Card.Handle` for custom
+ * card layouts that don't use `Card.Header` (e.g. `DeliverableCard`).
+ */
+interface CardHandleProps {
+    handle: string;
 }
 interface CardBodyProps extends React$1.HTMLAttributes<HTMLDivElement> {
 }
@@ -55,6 +69,7 @@ declare const Card: React$1.ForwardRefExoticComponent<CardProps & React$1.RefAtt
     Body: React$1.ForwardRefExoticComponent<CardBodyProps & React$1.RefAttributes<HTMLDivElement>>;
     Footer: React$1.ForwardRefExoticComponent<CardFooterProps & React$1.RefAttributes<HTMLDivElement>>;
     Media: React$1.ForwardRefExoticComponent<CardMediaProps & React$1.RefAttributes<HTMLDivElement>>;
+    Handle: React$1.FC<CardHandleProps>;
 };
 
 type ContainerSize = 'sm' | 'md' | 'lg' | 'xl' | 'fluid' | 'responsive';
@@ -243,6 +258,122 @@ interface FileChipProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'ch
 }
 declare const FileChip: React$1.ForwardRefExoticComponent<FileChipProps & React$1.RefAttributes<HTMLDivElement>>;
 
+interface MentionChipProps extends Omit<React$1.HTMLAttributes<HTMLSpanElement>, 'children' | 'onClick'> {
+    /**
+     * The artifact name (the @-handle, without the leading @).
+     */
+    name: string;
+    /**
+     * Optional human-readable title; shown in the hover tooltip alongside the name.
+     */
+    title?: string;
+    /**
+     * Optional icon rendered before the name — typically a kind glyph (e.g. `FileImage`,
+     * `FileVideo`) or `HelpCircle` for unknown / stale references. Sized at `w-3 h-3` to
+     * match the chip's text scale.
+     */
+    leadingIcon?: React$1.ReactNode;
+    /**
+     * Called when the chip is clicked. When provided, the chip becomes keyboard-focusable
+     * and gains a hover affordance.
+     */
+    onClick?: () => void;
+    /**
+     * Called when the remove (×) button is clicked. When provided, an × appears on hover/focus.
+     * Use only on input-side previews; rendered messages should leave this unset.
+     */
+    onRemove?: () => void;
+}
+/**
+ * Inline chip representing an `@name` artifact mention. Use anywhere a stable reference to a
+ * project artifact appears — typed input previews, rendered chat messages, deliverable
+ * descriptions. Renders the name in monospace with a leading `@` glyph and a gold-tinted border,
+ * mirroring the addressable handle the user sees on the artifact card.
+ *
+ * Pair with the `Combobox` primitive for the typing surface, and with the
+ * `MarkdownContent` `mentionRenderer` prop to render mentions inline inside rendered chat
+ * messages — typically `mentionRenderer={(name) => <MentionChip name={name} … />}`.
+ */
+declare const MentionChip: React$1.ForwardRefExoticComponent<MentionChipProps & React$1.RefAttributes<HTMLSpanElement>>;
+
+interface ComboboxProps<T> extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'children'> {
+    /**
+     * Items to display in the panel. The caller is responsible for filtering before passing.
+     */
+    items: T[];
+    /**
+     * Index of the currently highlighted (focused, not yet picked) item. Drive this from
+     * `useComboboxNav` for the standard arrow-key behaviour, or manage it yourself.
+     */
+    selectedIndex: number;
+    /**
+     * Render one row. `isSelected` reflects the keyboard highlight; click and hover styling
+     * are applied by the panel.
+     */
+    renderItem: (item: T, isSelected: boolean) => React$1.ReactNode;
+    /**
+     * Called when the user clicks a row. Use the same handler you call from the keyboard's
+     * Enter key to keep mouse and keyboard paths consistent.
+     */
+    onSelectItem: (item: T) => void;
+    /**
+     * Stable key per item. Required because the panel re-mounts rows when `items` changes.
+     */
+    getItemKey: (item: T) => string;
+    /**
+     * Optional node rendered when `items` is empty. Skip the panel entirely if you'd rather
+     * hide it on no-match.
+     */
+    emptyState?: React$1.ReactNode;
+    /**
+     * Maximum pixel height of the scrollable list. The panel itself sizes to its content
+     * up to this cap; rows beyond it scroll within the panel.
+     * @default 256
+     */
+    maxHeight?: number;
+}
+/**
+ * Floating panel for inline autocompletes — `@`-mention pickers, slash-command menus, and
+ * the like. The panel is unstyled-positioned (`absolute`) so the caller controls placement
+ * via wrapper, `style`, or by mounting it inside their own positioned container; this keeps
+ * the component agnostic to how the trigger position is computed (caret coordinates, ref
+ * rect, popover anchor).
+ *
+ * Pair with `useComboboxNav` for the standard arrow-key + Enter/Escape behaviour.
+ */
+declare function Combobox<T>({ items, selectedIndex, renderItem, onSelectItem, getItemKey, emptyState, maxHeight, className, ...rest }: ComboboxProps<T>): React$1.JSX.Element | null;
+/**
+ * Result of `useComboboxNav`. Forward `handleKeyDown` from the input element that owns focus
+ * (typically a textarea); it returns true when it consumed the event so the caller knows to
+ * skip its own handling.
+ */
+interface ComboboxNav {
+    selectedIndex: number;
+    setSelectedIndex: (index: number) => void;
+    /**
+     * Standard handler for ArrowUp / ArrowDown / Enter / Escape. Returns true when a key was
+     * consumed — the caller should skip its own handling for those events.
+     */
+    handleKeyDown: (e: React$1.KeyboardEvent) => boolean;
+}
+interface UseComboboxNavOptions<T> {
+    items: T[];
+    /**
+     * Called when the user presses Enter on the highlighted item.
+     */
+    onSelect: (item: T) => void;
+    /**
+     * Called when the user presses Escape.
+     */
+    onDismiss: () => void;
+}
+/**
+ * Standard keyboard nav for an inline autocomplete: ArrowUp / ArrowDown wrap through items,
+ * Enter selects the highlighted item, Escape dismisses. Resets the highlight to 0 whenever
+ * the items array changes (reference equality), so a fresh filter result starts at the top.
+ */
+declare function useComboboxNav<T>({ items, onSelect, onDismiss }: UseComboboxNavOptions<T>): ComboboxNav;
+
 interface AttachmentItem {
     /**
      * Unique identifier
@@ -438,6 +569,51 @@ declare const Modal: {
     displayName: string;
 };
 
+interface LightboxProps {
+    /**
+     * Called when the user dismisses the lightbox (ESC, backdrop click, X button).
+     * The caller owns the open/closed state — when `onClose` fires, unmount the
+     * lightbox.
+     */
+    onClose: () => void;
+    /**
+     * Optional kind-specific actions placed before the close button in the
+     * floating top-right cluster. Typically buttons like "Share" or "Download".
+     * The cluster always renders the close button; pass `undefined` if the only
+     * affordance is dismiss.
+     */
+    actions?: React$1.ReactNode;
+    /**
+     * Optional caption shown bottom-centre over the backdrop. Use for short
+     * metadata like a title and subtitle. Non-interactive — clicks pass through
+     * to the backdrop and dismiss.
+     */
+    caption?: React$1.ReactNode;
+    /**
+     * The artifact body. Sits directly on the backdrop with no inner frame —
+     * the body is responsible for its own layout (object-contain image, scrollable
+     * deliverable, readable text column, etc.). Click events whose target is the
+     * sized content wrapper (i.e. the empty area around the body) dismiss the
+     * lightbox; clicks on the body itself do not.
+     */
+    children: React$1.ReactNode;
+    className?: string;
+}
+/**
+ * Full-bleed modal canvas for one piece of content. Premium-haptic alternative
+ * to a bordered modal: deep void backdrop, scale-fade entrance, no inner frame,
+ * floating glass action cluster top-right.
+ *
+ * The component is content-agnostic — it ships chrome, not artifact knowledge.
+ * Compose it with kind-aware bodies and action sets to build the artifact
+ * viewer; reach for it directly any time a single piece of content needs the
+ * full screen.
+ *
+ * Dismiss surfaces: ESC, backdrop click (outside the sized content area),
+ * close button in the action cluster.
+ */
+declare function Lightbox({ onClose, actions, caption, children, className, }: LightboxProps): React$1.JSX.Element;
+
 type DrawerPosition = 'left' | 'right' | 'top' | 'bottom';
 interface DrawerProps {
     isOpen: boolean;
@@ -766,24 +942,42 @@ declare const StreamingCursor: React$1.ForwardRefExoticComponent<StreamingCursor
 
 interface MarkdownContentProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /**
-     * Content to display (can be Markdown or HTML)
+     * Content to display. Markdown by default; pass `isMarkdown={false}` for literal display
+     * of plain text (preserves whitespace, no parsing).
      */
     content: string;
     /**
-     * Whether the content should be treated as Markdown
+     * Whether the content should be parsed as Markdown. `false` renders the string verbatim
+     * inside a `whitespace-pre-wrap` block — useful for plain-text artifacts.
      * @default true
      */
     isMarkdown?: boolean;
-    sanitizeConfig?: Config;
     /**
-     * When true, injects a streaming cursor at the end of the content
+     * When true, injects a streaming cursor at the end of the rendered content.
      */
     isStreaming?: boolean;
     /**
-     * Additional classes for the streaming cursor
+     * Additional classes for the streaming cursor.
      */
     cursorClassName?: string;
+    /**
+     * When set, the renderer recognises `@artifact_name` mentions in prose (anywhere except
+     * inside code spans / blocks) and replaces each with the React node returned by this
+     * callback. Typical wiring is `(name) => <MentionChip name={name} onClick={...} />`,
+     * giving each chip a real per-call-site click handler.
+     *
+     * Without this prop, mentions render as literal `@name` text.
+     */
+    mentionRenderer?: (name: string) => React$1.ReactNode;
 }
+/**
+ * Renders Markdown content into a real React tree via `react-markdown`. Drop-in for prose
+ * surfaces (chat messages, artifact bodies, deliverable text). Optional `mentionRenderer`
+ * adds inline `@artifact_name` chip rendering — see prop docs.
+ *
+ * Raw HTML in the source is escaped (not rendered) by react-markdown's defaults; this is
+ * intentional and safer than the previous pipeline. Pass markdown.
+ */
 declare const MarkdownContent: React$1.ForwardRefExoticComponent<MarkdownContentProps & React$1.RefAttributes<HTMLDivElement>>;
 
 /**
@@ -1043,6 +1237,19 @@ interface ChatInputProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'o
      * Whether to automatically focus the input when it becomes enabled
      */
     autoFocus?: boolean;
+    /**
+     * Optional ref forwarded to the underlying `<textarea>`. Use this to drive an inline
+     * autocomplete (e.g. an `@`-mention picker) — read selection/caret position, mirror the
+     * textarea for caret coordinates, or imperatively update its value.
+     */
+    textareaRef?: React$1.Ref<HTMLTextAreaElement>;
+    /**
+     * Optional keydown hook that runs before the input's own handling. Call
+     * `e.preventDefault()` to stop ChatInput from acting on the event — for example, to keep
+     * Enter from submitting while an autocomplete is consuming it. The submit-on-Enter and
+     * default newline behaviours both check `defaultPrevented` and skip when set.
+     */
+    onTextareaKeyDown?: (e: React$1.KeyboardEvent<HTMLTextAreaElement>) => void;
 }
 /**
  * ChatInput is a context-aware input component that can transition between
@@ -1187,6 +1394,48 @@ interface ToolSidebarProps extends React$1.HTMLAttributes<HTMLDivElement> {
  */
 declare const ToolSidebar: React$1.ForwardRefExoticComponent<ToolSidebarProps & React$1.RefAttributes<HTMLDivElement>>;
 
+interface UseScrollAnchorOptions {
+    /**
+     * Behavior for scrolling. Defaults to 'smooth'.
+     */
+    behavior?: ScrollBehavior;
+    /**
+     * Block alignment for scrollIntoView. Defaults to 'start'.
+     */
+    block?: ScrollLogicalPosition;
+}
+interface UseScrollAnchorReturn {
+    /**
+     * Ref to attach to the scrollable container
+     */
+    containerRef: React.RefObject<HTMLDivElement | null>;
+    /**
+     * Ref to attach to the anchor element (latest user message)
+     */
+    anchorRef: React.RefObject<HTMLDivElement | null>;
+    /**
+     * Scroll the anchor element into view. Call this on user message submission.
+     */
+    scrollToAnchor: () => void;
+    /**
+     * Scroll to the bottom of the container.
+     */
+    scrollToBottom: () => void;
+    /**
+     * Check if user has scrolled away from the bottom.
+     */
+    isScrolledToBottom: () => boolean;
+}
+/**
+ * Hook for smart scroll behavior in chat interfaces.
+ *
+ * Key behaviors:
+ * - Anchors user messages to the top of the viewport when they send a message
+ * - Does NOT auto-scroll during streaming to respect user's reading position
+ * - Allows manual scroll detection
+ */
+declare function useScrollAnchor(options?: UseScrollAnchorOptions): UseScrollAnchorReturn;
+
 /**
  * Script element types following standard screenplay format
  */
@@ -1223,6 +1472,8 @@ interface ScriptCardProps extends Omit<CardProps, 'title'> {
      * Subtitle/metadata (e.g., "30-second spot • Directed by AI Creative")
      */
     subtitle?: React$1.ReactNode;
+    /** The artifact's `@-handle` — see `Card.Header.handle`. */
+    handle?: string;
     /**
      * Array of script elements in order.
      * Available types: 'scene-heading', 'action', 'character', 'dialogue', 'parenthetical',
@@ -1261,116 +1512,351 @@ interface ScriptCardProps extends Omit<CardProps, 'title'> {
 declare const ScriptCard: React$1.ForwardRefExoticComponent<ScriptCardProps & React$1.RefAttributes<HTMLDivElement>>;
 
 /**
- * Artifact types supported by the system
- */
-declare const ARTIFACT_TYPES: {
-    readonly TEXT: "TEXT";
-    readonly IMAGE: "IMAGE";
-    readonly VIDEO: "VIDEO";
-    readonly AUDIO: "AUDIO";
-    readonly SCRIPT: "SCRIPT";
-    readonly PDF: "PDF";
-};
-type ArtifactType = typeof ARTIFACT_TYPES[keyof typeof ARTIFACT_TYPES];
-interface Artifact {
-    id: string;
-    type: ArtifactType;
-    /**
-     * For text artifacts - the content (markdown, HTML, or plain text)
-     */
-    inlineContent?: string;
-    /**
-     * For artifacts that source from a URL (image, video, audio, pdf, file)
-     */
-    url?: string;
-    /**
-     * The mime type of the content
-     */
-    mimeType?: string;
-    /**
-     * For image artifacts - alt text
-     */
-    alt?: string;
-    /**
-     * Display title shown below the artifact
-     */
-    title?: string;
-    /**
-     * Display subtitle shown below the title
-     */
-    subtitle?: string;
-    /**
-     * Whether this artifact is still loading (shows skeleton)
-     */
-    isPending?: boolean;
-    /**
-     * Whether the artifact should span full width in the grid
-     */
-    fullWidth?: boolean;
-    /**
-     * For html artifacts - structured script elements (used by ScriptCard)
-     */
-    scriptElements?: ScriptElement[];
-}
-interface ArtifactCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
-    /**
-     * The artifact object to display
-     */
-    artifact: Artifact;
-    /**
-     * Callback when the artifact should be expanded/opened
-     */
-    onExpand?: (artifact: Artifact) => void;
-    /**
-     * Whether the artifact is still loading
-     */
-    loading?: CardSlotLoading;
-}
-/**
- * A dispatcher component that renders the appropriate specialist card
- * based on the artifact type.
+ * Wire format for a presentable deliverable. The document is composed once by
+ * the backend (or hand-authored) and rendered here — the renderer never reads
+ * raw HTML from data, it dispatches on `type` to a typed component per section.
+ *
+ * The shape mirrors hypocaust's `ResolvedDeliverableDto`. When the OpenAPI
+ * client is regenerated downstream of a hypocaust schema change, the types
+ * here should be kept aligned.
  */
-declare const ArtifactCard: React$1.ForwardRefExoticComponent<ArtifactCardProps & React$1.RefAttributes<HTMLDivElement>>;
-
 /**
- * Node types in the artifact tree
+ * Top-level deliverable. Holds metadata used on the cover and an ordered list
+ * of sections to render.
  */
-declare const NODE_TYPES: {
-    readonly ARTIFACT: "ARTIFACT";
-    readonly GROUP: "GROUP";
-    readonly VARIANT_SET: "VARIANT_SET";
-};
-type NodeType = typeof NODE_TYPES[keyof typeof NODE_TYPES];
+interface Deliverable {
+    /** Schema version. 1 today. */
+    version: number;
+    /** Document title — also used as the default cover title. */
+    title: string;
+    /** Optional one-line subtitle / tagline. */
+    subtitle?: string | null;
+    /** Optional client name shown as "Prepared for {clientName}" on the cover. */
+    clientName?: string | null;
+    /** Optional accent hex color (e.g. "#fecb6b"). Falls back to design-system gold. */
+    accentColor?: string | null;
+    /** Ordered sections. Render in array order. */
+    sections: DeliverableSection[];
+}
 /**
- * A node in the artifact tree. Mirrors the backend ArtifactNode shape.
- * Groups and variant sets contain children; artifact nodes link to content.
+ * Discriminated union of section types. Each variant has a matching renderer
+ * in aurelius — the agent fills the spec, never raw layout instructions.
  */
-interface ArtifactNode {
-    /**
-     * Unique identifier
-     */
-    id: string;
-    /**
-     * The node type — ARTIFACT, GROUP, or VARIANT_SET
-     */
-    type: NodeType;
-    /**
-     * Semantic name (e.g. "storyboard", "protagonist_warm")
-     */
-    name: string;
-    /**
-     * Display label (e.g. "Storyboard", "Warm Analog")
-     */
-    label: string;
-    /**
-     * For ARTIFACT nodes — the actual content. Null for GROUP and VARIANT_SET.
-     */
-    artifact?: Artifact;
-    /**
-     * Child nodes (populated for GROUP and VARIANT_SET)
-     */
-    children: ArtifactNode[];
-}
+type DeliverableSection = CoverSection$1 | ArtifactImageGridSection$1 | ArtifactSpotlightSection$1 | TextBlockSection$1 | ColorPaletteSection$1 | QuoteBlockSection$1;
+interface CoverSection$1 {
+    type: 'COVER';
+    eyebrow?: string | null;
+    title: string;
+    subtitle?: string | null;
+}
+interface ArtifactImageGridSection$1 {
+    type: 'ARTIFACT_IMAGE_GRID';
+    heading?: string | null;
+    /** 1, 2 or 3. */
+    columns: number;
+    items: DeliverableImageItem[];
+}
+interface ArtifactSpotlightSection$1 {
+    type: 'ARTIFACT_SPOTLIGHT';
+    heading?: string | null;
+    artifact: DeliverableArtifactRef;
+    body?: string | null;
+}
+interface TextBlockSection$1 {
+    type: 'TEXT_BLOCK';
+    heading?: string | null;
+    body: string;
+}
+interface ColorPaletteSection$1 {
+    type: 'COLOR_PALETTE';
+    heading?: string | null;
+    swatches: DeliverableSwatch[];
+}
+interface QuoteBlockSection$1 {
+    type: 'QUOTE_BLOCK';
+    quote: string;
+    attribution?: string | null;
+}
+interface DeliverableImageItem {
+    artifact: DeliverableArtifactRef;
+    caption?: string | null;
+}
+interface DeliverableSwatch {
+    color: string;
+    label: string;
+}
+/**
+ * Minimal subset of the hypocaust ArtifactDto shape consumed by the renderer.
+ * Only the fields needed to render a deliverable's referenced artifacts.
+ */
+interface DeliverableArtifactRef {
+    url?: string | null;
+    title?: string | null;
+    description?: string | null;
+}
+
+interface DeliverableRendererProps {
+    /** Resolved deliverable spec — every artifact reference already inflated. */
+    deliverable: Deliverable;
+    /**
+     * Called when the viewer requests a PDF download. The host application is
+     * responsible for fetching and triggering the file save (the URL knows
+     * about share tokens and credentials we don't). When omitted, the download
+     * affordance is hidden.
+     */
+    onDownloadPdf?: () => void | Promise<void>;
+    /** Hide the floating action bar entirely. Used when rendering for print. */
+    hideActions?: boolean;
+    className?: string;
+}
+/**
+ * Render a presentable deliverable (moodboard, pitch deck) from a structured
+ * spec. The same component drives the on-screen view and the print/PDF
+ * version — `@media print` styles in `aurelius/styles/base.css` keep them in
+ * sync. To produce a PDF, drive the page with headless Chromium and let the
+ * print stylesheet do the work.
+ *
+ * The renderer is purely presentational: it takes a fully resolved spec
+ * (artifact URLs already inflated by the caller) and dispatches each section
+ * to its typed sub-renderer. Unknown section types are skipped silently
+ * forward-compat for new section variants added by the backend.
+ */
+declare function DeliverableRenderer({ deliverable, onDownloadPdf, hideActions, className, }: DeliverableRendererProps): React$1.JSX.Element;
+
+interface CoverSectionProps {
+    data: CoverSection$1;
+    /** Document-level client name from {@link Deliverable.clientName}, shown as "Prepared for {name}". */
+    clientName?: string | null;
+}
+/**
+ * Title page for a deliverable. Always rendered as the first section.
+ */
+declare function CoverSection({ data, clientName }: CoverSectionProps): React$1.JSX.Element;
+
+interface ArtifactImageGridSectionProps {
+    data: ArtifactImageGridSection$1;
+}
+/**
+ * Grid of project artifact images with optional captions. The number of
+ * columns is fixed by the spec (1–3); the renderer enforces a sensible aspect
+ * ratio per item and lets the browser flow rows.
+ */
+declare function ArtifactImageGridSection({ data }: ArtifactImageGridSectionProps): React$1.JSX.Element;
+
+interface ArtifactSpotlightSectionProps {
+    data: ArtifactSpotlightSection$1;
+}
+/**
+ * A single hero artifact image with optional prose alongside. Reads at full
+ * page width on screen and prints to a single page.
+ */
+declare function ArtifactSpotlightSection({ data }: ArtifactSpotlightSectionProps): React$1.JSX.Element;
+
+interface TextBlockSectionProps {
+    data: TextBlockSection$1;
+}
+/**
+ * Prose section. Body is rendered as Markdown.
+ */
+declare function TextBlockSection({ data }: TextBlockSectionProps): React$1.JSX.Element;
+
+interface ColorPaletteSectionProps {
+    data: ColorPaletteSection$1;
+}
+/**
+ * Color palette presented as labelled swatches with hex values.
+ */
+declare function ColorPaletteSection({ data }: ColorPaletteSectionProps): React$1.JSX.Element;
+
+interface QuoteBlockSectionProps {
+    data: QuoteBlockSection$1;
+}
+/**
+ * Pulled quote with optional attribution. The renderer adds the surrounding
+ * quotation marks.
+ */
+declare function QuoteBlockSection({ data }: QuoteBlockSectionProps): React$1.JSX.Element;
+
+/**
+ * Artifact types supported by the system
+ */
+declare const ARTIFACT_TYPES: {
+    readonly TEXT: "TEXT";
+    readonly IMAGE: "IMAGE";
+    readonly VIDEO: "VIDEO";
+    readonly AUDIO: "AUDIO";
+    readonly SCRIPT: "SCRIPT";
+    readonly PDF: "PDF";
+    readonly DELIVERABLE: "DELIVERABLE";
+};
+type ArtifactType = typeof ARTIFACT_TYPES[keyof typeof ARTIFACT_TYPES];
+interface Artifact {
+    id: string;
+    type: ArtifactType;
+    /**
+     * For text artifacts - the content (markdown, HTML, or plain text)
+     */
+    inlineContent?: string;
+    /**
+     * For artifacts that source from a URL (image, video, audio, pdf, file)
+     */
+    url?: string;
+    /**
+     * The mime type of the content
+     */
+    mimeType?: string;
+    /**
+     * For image artifacts - alt text
+     */
+    alt?: string;
+    /**
+     * Display title shown below the artifact
+     */
+    title?: string;
+    /**
+     * Display subtitle shown below the title
+     */
+    subtitle?: string;
+    /**
+     * Whether this artifact is still loading (shows skeleton)
+     */
+    isPending?: boolean;
+    /**
+     * Whether the artifact should span full width in the grid
+     */
+    fullWidth?: boolean;
+    /**
+     * For html artifacts - structured script elements (used by ScriptCard)
+     */
+    scriptElements?: ScriptElement[];
+    /**
+     * For deliverable artifacts - the resolved presentation spec, every artifact
+     * reference already inflated. Rendered as a compact card that links to the
+     * full DeliverableRenderer; surfaces the cover info and section count.
+     */
+    deliverable?: Deliverable;
+}
+interface ArtifactCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /**
+     * The artifact object to display
+     */
+    artifact: Artifact;
+    /**
+     * Callback when the artifact should be expanded/opened
+     */
+    onExpand?: (artifact: Artifact) => void;
+    /**
+     * Whether the artifact is still loading
+     */
+    loading?: CardSlotLoading;
+}
+/**
+ * A dispatcher component that renders the appropriate specialist card
+ * based on the artifact type.
+ */
+declare const ArtifactCard: React$1.ForwardRefExoticComponent<ArtifactCardProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface UseResizableProps {
+    /**
+     * Initial width as percentage of viewport (0-100)
+     */
+    initialWidthPercent: number;
+    /**
+     * Minimum width as percentage of viewport (0-100)
+     */
+    minWidthPercent: number;
+    /**
+     * Maximum width as percentage of viewport (0-100)
+     */
+    maxWidthPercent: number;
+    /**
+     * Direction to resize from
+     */
+    direction: 'left' | 'right';
+}
+/**
+ * Hook for resizable panels with percentage-based widths.
+ * Returns width as a CSS percentage string (e.g., "50%").
+ */
+declare function useResizable({ initialWidthPercent, minWidthPercent, maxWidthPercent, direction, }: UseResizableProps): {
+    width: string;
+    widthPercent: number;
+    isResizing: boolean;
+    startResizing: (e: React.MouseEvent) => void;
+};
+
+/**
+ * Node types in the artifact tree
+ */
+declare const NODE_TYPES: {
+    readonly ARTIFACT: "ARTIFACT";
+    readonly GROUP: "GROUP";
+    readonly VARIANT_SET: "VARIANT_SET";
+};
+type NodeType = typeof NODE_TYPES[keyof typeof NODE_TYPES];
+/**
+ * A node in the artifact tree. Mirrors the backend ArtifactNode shape.
+ * Groups and variant sets contain children; artifact nodes link to content.
+ */
+interface ArtifactNode {
+    /**
+     * Unique identifier
+     */
+    id: string;
+    /**
+     * The node type — ARTIFACT, GROUP, or VARIANT_SET
+     */
+    type: NodeType;
+    /**
+     * Semantic name (e.g. "storyboard", "protagonist_warm")
+     */
+    name: string;
+    /**
+     * Display label (e.g. "Storyboard", "Warm Analog")
+     */
+    label: string;
+    /**
+     * For ARTIFACT nodes — the actual content. Null for GROUP and VARIANT_SET.
+     */
+    artifact?: Artifact;
+    /**
+     * Child nodes (populated for GROUP and VARIANT_SET)
+     */
+    children: ArtifactNode[];
+}
+
+/**
+ * A breadcrumb entry representing one level of navigation depth.
+ */
+interface BreadcrumbEntry {
+    /** Display label for this level */
+    label: string;
+    /** The group node at this level (null for root) */
+    node: ArtifactNode | null;
+}
+/**
+ * Return type for the useArtifactTreeNavigation hook.
+ */
+interface UseArtifactTreeNavigationReturn {
+    /** Nodes to display at the current navigation level */
+    currentNodes: ArtifactNode[];
+    /** Breadcrumb trail from root to current level */
+    breadcrumbs: BreadcrumbEntry[];
+    /** Whether the user is at the root level */
+    isAtRoot: boolean;
+    /** Navigate into a group node, pushing it onto the stack */
+    navigateInto: (node: ArtifactNode) => void;
+    /** Navigate to a specific breadcrumb level by index */
+    navigateTo: (index: number) => void;
+    /** Navigate back one level */
+    navigateBack: () => void;
+}
+/**
+ * Manages navigation state for an artifact tree panel.
+ * Maintains a stack of group nodes the user has navigated into,
+ * deriving children from the node references themselves.
+ */
+declare function useArtifactTreeNavigation(rootNodes: ArtifactNode[]): UseArtifactTreeNavigationReturn;
 
 interface Conversation {
     /**
@@ -1529,6 +2015,17 @@ interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>
      * Called when the artifacts panel is opened or closed (controlled).
      */
     onArtifactsPanelOpenChange?: (open: boolean) => void;
+    /**
+     * Resolves the floating action cluster shown over the artifact lightbox.
+     * The host switches on `artifact.type` and returns the right buttons for
+     * that kind (e.g. Share + Download for deliverables, Download for images).
+     * Aurelius ships the close affordance itself; return only the kind-specific
+     * actions, or `null` when none. Use `ctx.onClose` to dismiss the lightbox
+     * after a successful operation.
+     */
+    getArtifactActions?: (artifact: Artifact, ctx: {
+        onClose: () => void;
+    }) => React$1.ReactNode;
     /**
      * Tasks to display in the todos list tool panel.
      * Shows a list of tasks with status indicators.
@@ -1576,6 +2073,20 @@ interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>
      * Defaults to true.
      */
     autoFocus?: boolean;
+    /**
+     * Forwarded to the underlying chat-input `<textarea>`. Use to drive an
+     * inline autocomplete (e.g. an `@`-mention picker) — read selection/caret
+     * position, mirror the textarea for caret coordinates, or imperatively
+     * update its value.
+     */
+    textareaRef?: React$1.Ref<HTMLTextAreaElement>;
+    /**
+     * Forwarded to the underlying chat-input. Runs before the input's own
+     * keydown handling; calling `e.preventDefault()` opts that event out of
+     * default behaviour (submit-on-Enter, newline) — typical use is to claim
+     * Arrow / Enter / Escape while an autocomplete panel is open.
+     */
+    onTextareaKeyDown?: (e: React$1.KeyboardEvent<HTMLTextAreaElement>) => void;
 }
 /**
  * ChatInterface is the main orchestrator for a full-featured chat experience.
@@ -1729,13 +2240,11 @@ interface ChatViewProps extends React$1.HTMLAttributes<HTMLDivElement> {
      * last-found user message in `items`.
      */
     latestUserMessageIndex?: number;
-    /**
-     * Whether the assistant is currently streaming a response. Drives the
-     * streaming cursor on the last assistant message and the thinking indicator.
-     */
-    isStreaming?: boolean;
     /**
      * Whether to show the thinking indicator (between user message and response).
+     * Renders only when the latest message is a user turn — i.e. the assistant
+     * hasn't sent its first chunk yet. Streaming-cursor behavior is owned by
+     * the per-node {@code isStreaming} flag on each message item.
      */
     isThinking?: boolean;
     /**
@@ -1782,6 +2291,17 @@ interface ArtifactsPanelProps extends React$1.HTMLAttributes<HTMLDivElement> {
      * `openArtifactId`.
      */
     onArtifactClosed?: () => void;
+    /**
+     * Resolves the floating action cluster shown over the lightbox when an
+     * artifact is opened. Switch on `artifact.type` and return the host-owned
+     * buttons for that kind (e.g. Share + Download for deliverables, Download
+     * for images). Aurelius ships the close affordance itself; return only the
+     * kind-specific actions, or `null` when there are none. The `ctx.onClose`
+     * helper lets actions dismiss the lightbox after a successful operation.
+     */
+    getArtifactActions?: (artifact: Artifact, ctx: {
+        onClose: () => void;
+    }) => React$1.ReactNode;
 }
 /**
  * ArtifactsPanel displays artifacts in a navigable tree panel.
@@ -1986,165 +2506,92 @@ declare const BranchNavigator: React$1.ForwardRefExoticComponent<BranchNavigator
 
 declare function createEmptyTree<T extends NodeTopology = ChatNode>(): ConversationTree<T>;
 /**
- * Append a node under `parentId` (or as a root when null) and make it the new
- * active leaf. Sending a message, retrying, editing, and submitting all go
- * through here — the tree doesn't care which one. `lastLeafId` is reset to the
- * new node since by definition the user is now at a fresh deepest leaf.
- */
-declare function addNodeToTree<T extends NodeTopology>(tree: ConversationTree<T>, node: T, parentId?: string | null): ConversationTree<T>;
-/**
- * Walk root → activeLeaf, returning the nodes on the active path in order.
- */
-declare function getActivePath<T extends NodeTopology>(tree: ConversationTree<T>): TreeNode<T>[];
-/**
- * Walk from `fromId` upward and return the first ancestor (inclusive) that
- * matches the predicate. Domain helpers compose on top — e.g. finding the
- * closest checkpoint is `findAncestor(t, id, n => n.kind === 'checkpoint')`.
- */
-declare function findAncestor<T extends NodeTopology>(tree: ConversationTree<T>, fromId: string | null, predicate: (node: TreeNode<T>) => boolean): TreeNode<T> | null;
-declare function getSiblingInfo<T extends NodeTopology>(tree: ConversationTree<T>, nodeId: string): {
-    total: number;
-    current: number;
-};
-declare function isBranchPoint<T extends NodeTopology>(tree: ConversationTree<T>, nodeId: string): boolean;
-/**
- * Switch to a sibling branch at `nodeId` and follow first-children down to a
- * leaf. Used by the BranchNavigator chevrons. Resets `lastLeafId` to the new
- * leaf because the previous greyed-future, if any, lives on a different branch.
- */
-declare function switchBranch<T extends NodeTopology>(tree: ConversationTree<T>, nodeId: string, direction: 'prev' | 'next'): ConversationTree<T>;
-/**
- * Set the active leaf without forking. Use for rewinds (clicking a checkpoint),
- * jumping forward into the greyed future, and "jump to latest".
- *
- * Preserves `lastLeafId` when the new leaf is an ancestor of it (i.e. the user
- * rewound, or moved within the rewound region). Otherwise resets `lastLeafId`
- * to the new leaf — the greyed future doesn't carry over to unrelated paths.
- */
-declare function setActiveLeaf<T extends NodeTopology>(tree: ConversationTree<T>, leafId: string | null): ConversationTree<T>;
-/**
- * Nodes between `activeLeafId` (exclusive) and `lastLeafId` (inclusive) — the
- * timeline the user rewound away from. Empty whenever no rewind is in effect.
- */
-declare function getGreyedFuture<T extends NodeTopology>(tree: ConversationTree<T>): TreeNode<T>[];
-/**
- * Convenience: build a strictly linear message-only tree from a flat array.
- * Useful for tests, fixtures, and consumers that don't care about branching.
- */
-declare function messagesToTree(messages: Array<Omit<MessageNode, 'kind' | 'parentId'>>): ConversationTree<MessageNode>;
-/**
- * Update a streaming message's content. Generic over the tree's node type so
- * the function works equally on message-only trees (`ConversationTree<MessageNode>`)
- * and mixed trees (`ConversationTree<ChatNode>`). At runtime it narrows to
- * `MessageNode` via the `kind` discriminator and silently no-ops on any other
- * kind. The single cast below is the cost of bridging a generic-T tree to the
- * concrete `MessageNode` shape it operates on.
- */
-declare function updateMessageContent<T extends NodeTopology>(tree: ConversationTree<T>, nodeId: string, content: ReactNode, isStreaming?: boolean): ConversationTree<T>;
-
-interface UseScrollAnchorOptions {
-    /**
-     * Behavior for scrolling. Defaults to 'smooth'.
-     */
-    behavior?: ScrollBehavior;
-    /**
-     * Block alignment for scrollIntoView. Defaults to 'start'.
-     */
-    block?: ScrollLogicalPosition;
-}
-interface UseScrollAnchorReturn {
-    /**
-     * Ref to attach to the scrollable container
-     */
-    containerRef: React.RefObject<HTMLDivElement | null>;
-    /**
-     * Ref to attach to the anchor element (latest user message)
-     */
-    anchorRef: React.RefObject<HTMLDivElement | null>;
-    /**
-     * Scroll the anchor element into view. Call this on user message submission.
-     */
-    scrollToAnchor: () => void;
-    /**
-     * Scroll to the bottom of the container.
-     */
-    scrollToBottom: () => void;
-    /**
-     * Check if user has scrolled away from the bottom.
-     */
-    isScrolledToBottom: () => boolean;
-}
-/**
- * Hook for smart scroll behavior in chat interfaces.
- *
- * Key behaviors:
- * - Anchors user messages to the top of the viewport when they send a message
- * - Does NOT auto-scroll during streaming to respect user's reading position
- * - Allows manual scroll detection
+ * Options for {@link addNodeToTree}.
  */
-declare function useScrollAnchor(options?: UseScrollAnchorOptions): UseScrollAnchorReturn;
-
-interface UseResizableProps {
-    /**
-     * Initial width as percentage of viewport (0-100)
-     */
-    initialWidthPercent: number;
-    /**
-     * Minimum width as percentage of viewport (0-100)
-     */
-    minWidthPercent: number;
-    /**
-     * Maximum width as percentage of viewport (0-100)
-     */
-    maxWidthPercent: number;
+interface AddNodeOptions {
     /**
-     * Direction to resize from
+     * Whether the new node should become the active leaf. Defaults to `true`,
+     * matching the historical "create-and-focus" behaviour: a freshly added
+     * node almost always represents the latest user-visible state.
+     *
+     * Pass `false` when focus is decided by a separate signal — e.g. an SSE
+     * stream that emits `active_leaf_set` only when the new node *should*
+     * pull focus (the previous active leaf was its parent), and otherwise
+     * leaves the user wherever they navigated to.
+     *
+     * `lastLeafId` follows the same rule: it only advances to the new node
+     * when the node is activated, since "deepest leaf the user has reached"
+     * does not include nodes the system added off-screen.
+     *
+     * @default true
      */
-    direction: 'left' | 'right';
+    activate?: boolean;
 }
 /**
- * Hook for resizable panels with percentage-based widths.
- * Returns width as a CSS percentage string (e.g., "50%").
+ * Append a node under `parentId` (or as a root when null). By default the new
+ * node also becomes the active leaf — sending a message, retrying, editing,
+ * and submitting all rely on that. Pass `{activate: false}` to insert without
+ * pulling focus, e.g. for off-branch updates from a stream.
  */
-declare function useResizable({ initialWidthPercent, minWidthPercent, maxWidthPercent, direction, }: UseResizableProps): {
-    width: string;
-    widthPercent: number;
-    isResizing: boolean;
-    startResizing: (e: React.MouseEvent) => void;
+declare function addNodeToTree<T extends NodeTopology>(tree: ConversationTree<T>, node: T, parentId?: string | null, options?: AddNodeOptions): ConversationTree<T>;
+/**
+ * Walk root → activeLeaf, returning the nodes on the active path in order.
+ */
+declare function getActivePath<T extends NodeTopology>(tree: ConversationTree<T>): TreeNode<T>[];
+/**
+ * Walk from `fromId` upward and return the first ancestor (inclusive) that
+ * matches the predicate. Domain helpers compose on top — e.g. finding the
+ * closest checkpoint is `findAncestor(t, id, n => n.kind === 'checkpoint')`.
+ */
+declare function findAncestor<T extends NodeTopology>(tree: ConversationTree<T>, fromId: string | null, predicate: (node: TreeNode<T>) => boolean): TreeNode<T> | null;
+declare function getSiblingInfo<T extends NodeTopology>(tree: ConversationTree<T>, nodeId: string): {
+    total: number;
+    current: number;
 };
-
+declare function isBranchPoint<T extends NodeTopology>(tree: ConversationTree<T>, nodeId: string): boolean;
 /**
- * A breadcrumb entry representing one level of navigation depth.
+ * Switch to a sibling branch at `nodeId` and follow first-children down to a
+ * leaf. Used by the BranchNavigator chevrons. Resets `lastLeafId` to the new
+ * leaf because the previous greyed-future, if any, lives on a different branch.
  */
-interface BreadcrumbEntry {
-    /** Display label for this level */
-    label: string;
-    /** The group node at this level (null for root) */
-    node: ArtifactNode | null;
-}
+declare function switchBranch<T extends NodeTopology>(tree: ConversationTree<T>, nodeId: string, direction: 'prev' | 'next'): ConversationTree<T>;
 /**
- * Return type for the useArtifactTreeNavigation hook.
+ * Set the active leaf without forking. Use for rewinds (clicking a checkpoint),
+ * jumping forward into the greyed future, and "jump to latest".
+ *
+ * Preserves `lastLeafId` when the new leaf is an ancestor of it (i.e. the user
+ * rewound, or moved within the rewound region). Otherwise resets `lastLeafId`
+ * to the new leaf — the greyed future doesn't carry over to unrelated paths.
+ *
+ * `null` clears the active leaf (empty session). An id that doesn't exist in
+ * the tree is treated as a no-op rather than written through — the previous
+ * behaviour silently set `activeLeafId` to a non-existent id, which made
+ * `getActivePath` walk from a missing node and return an empty path. That
+ * presented as "the chat just cleared" for callers that accidentally passed
+ * a foreign id (a hypocaust execution id, a stale optimistic temp id, etc.).
+ * A no-op turns those caller bugs into visible "nothing happened" instead of
+ * an invisible empty-render.
  */
-interface UseArtifactTreeNavigationReturn {
-    /** Nodes to display at the current navigation level */
-    currentNodes: ArtifactNode[];
-    /** Breadcrumb trail from root to current level */
-    breadcrumbs: BreadcrumbEntry[];
-    /** Whether the user is at the root level */
-    isAtRoot: boolean;
-    /** Navigate into a group node, pushing it onto the stack */
-    navigateInto: (node: ArtifactNode) => void;
-    /** Navigate to a specific breadcrumb level by index */
-    navigateTo: (index: number) => void;
-    /** Navigate back one level */
-    navigateBack: () => void;
-}
+declare function setActiveLeaf<T extends NodeTopology>(tree: ConversationTree<T>, leafId: string | null): ConversationTree<T>;
 /**
- * Manages navigation state for an artifact tree panel.
- * Maintains a stack of group nodes the user has navigated into,
- * deriving children from the node references themselves.
+ * Nodes between `activeLeafId` (exclusive) and `lastLeafId` (inclusive) — the
+ * timeline the user rewound away from. Empty whenever no rewind is in effect.
  */
-declare function useArtifactTreeNavigation(rootNodes: ArtifactNode[]): UseArtifactTreeNavigationReturn;
+declare function getGreyedFuture<T extends NodeTopology>(tree: ConversationTree<T>): TreeNode<T>[];
+/**
+ * Convenience: build a strictly linear message-only tree from a flat array.
+ * Useful for tests, fixtures, and consumers that don't care about branching.
+ */
+declare function messagesToTree(messages: Array<Omit<MessageNode, 'kind' | 'parentId'>>): ConversationTree<MessageNode>;
+/**
+ * Update a streaming message's content. Generic over the tree's node type so
+ * the function works equally on message-only trees (`ConversationTree<MessageNode>`)
+ * and mixed trees (`ConversationTree<ChatNode>`). At runtime it narrows to
+ * `MessageNode` via the `kind` discriminator and silently no-ops on any other
+ * kind. The single cast below is the cost of bridging a generic-T tree to the
+ * concrete `MessageNode` shape it operates on.
+ */
+declare function updateMessageContent<T extends NodeTopology>(tree: ConversationTree<T>, nodeId: string, content: ReactNode, isStreaming?: boolean): ConversationTree<T>;
 
 type BrandIconSize = 'sm' | 'md' | 'lg';
 type BrandIconVariant = 'solid' | 'outline';
@@ -2167,6 +2614,8 @@ interface ImageCardProps extends Omit<CardProps, 'title'> {
     alt?: string;
     title?: React$1.ReactNode;
     subtitle?: React$1.ReactNode;
+    /** The artifact's `@-handle` — see `Card.Header.handle`. */
+    handle?: string;
     aspectRatio?: AspectRatio;
     objectFit?: 'cover' | 'contain';
     overlay?: React$1.ReactNode;
@@ -2183,6 +2632,8 @@ interface VideoCardProps extends Omit<CardProps, 'title'> {
     src?: string;
     title?: React$1.ReactNode;
     subtitle?: React$1.ReactNode;
+    /** The artifact's `@-handle` — see `Card.Header.handle`. */
+    handle?: string;
     aspectRatio?: VideoAspectRatio;
     playing?: boolean;
     controls?: boolean;
@@ -2203,6 +2654,8 @@ interface AudioCardProps extends Omit<CardProps, 'title'> {
     src?: string;
     title?: React$1.ReactNode;
     subtitle?: React$1.ReactNode;
+    /** The artifact's `@-handle` — see `Card.Header.handle`. */
+    handle?: string;
     playing?: boolean;
     controls?: boolean;
     volume?: number;
@@ -2230,6 +2683,8 @@ interface PdfCardProps extends Omit<CardProps, 'title'> {
      * Subtitle or document metadata
      */
     subtitle?: React$1.ReactNode;
+    /** The artifact's `@-handle` — see `Card.Header.handle`. */
+    handle?: string;
     /**
      * Height of the PDF viewer
      */
@@ -2262,6 +2717,8 @@ interface TextCardProps extends Omit<CardProps, 'title'> {
      * Optional subtitle or metadata
      */
     subtitle?: React$1.ReactNode;
+    /** The artifact's `@-handle` — see `Card.Header.handle`. */
+    handle?: string;
     /**
      * Whether the content should be treated as Markdown
      * @default true
@@ -2283,6 +2740,29 @@ interface TextCardProps extends Omit<CardProps, 'title'> {
  */
 declare const TextCard: React$1.ForwardRefExoticComponent<TextCardProps & React$1.RefAttributes<HTMLDivElement>>;
 
+interface DeliverableCardProps extends Omit<CardProps, 'title'> {
+    /**
+     * Resolved deliverable spec — every artifact reference already inflated.
+     * Same shape the full DeliverableRenderer accepts.
+     */
+    deliverable?: Deliverable;
+    /** Optional override for the cover title (otherwise derived from the spec). */
+    title?: React$1.ReactNode;
+    /** Optional subtitle shown below the title. */
+    subtitle?: React$1.ReactNode;
+    /** The artifact's `@-handle` — see `Card.Header.handle`. */
+    handle?: string;
+    loading?: CardSlotLoading;
+}
+/**
+ * Compact preview of a deliverable for surfaces that can't host the full
+ * multi-page renderer (chat tree, artifact lists). Surfaces the deliverable's
+ * cover info plus its section count. The whole card is clickable — the
+ * affordance is the same expand-icon overlay that {@link ArtifactCard} shows
+ * for every artifact kind, so we don't add a "Open preview" lure here.
+ */
+declare const DeliverableCard: React$1.ForwardRefExoticComponent<DeliverableCardProps & React$1.RefAttributes<HTMLDivElement>>;
+
 type SectionHeadingLevel = 'h2' | 'h3';
 interface SectionHeadingProps extends React$1.HTMLAttributes<HTMLHeadingElement> {
     level?: SectionHeadingLevel;
@@ -2329,171 +2809,15 @@ interface ArtifactVariantStackProps extends React$1.HTMLAttributes<HTMLDivElemen
  */
 declare const ArtifactVariantStack: React$1.ForwardRefExoticComponent<ArtifactVariantStackProps & React$1.RefAttributes<HTMLDivElement>>;
 
-/**
- * Wire format for a presentable deliverable. The document is composed once by
- * the backend (or hand-authored) and rendered here — the renderer never reads
- * raw HTML from data, it dispatches on `type` to a typed component per section.
- *
- * The shape mirrors hypocaust's `ResolvedDeliverableDto`. When the OpenAPI
- * client is regenerated downstream of a hypocaust schema change, the types
- * here should be kept aligned.
- */
-/**
- * Top-level deliverable. Holds metadata used on the cover and an ordered list
- * of sections to render.
- */
-interface Deliverable {
-    /** Schema version. 1 today. */
-    version: number;
-    /** Document title — also used as the default cover title. */
-    title: string;
-    /** Optional one-line subtitle / tagline. */
-    subtitle?: string | null;
-    /** Optional client name shown as "Prepared for {clientName}" on the cover. */
-    clientName?: string | null;
-    /** Optional accent hex color (e.g. "#fecb6b"). Falls back to design-system gold. */
-    accentColor?: string | null;
-    /** Ordered sections. Render in array order. */
-    sections: DeliverableSection[];
-}
-/**
- * Discriminated union of section types. Each variant has a matching renderer
- * in aurelius — the agent fills the spec, never raw layout instructions.
- */
-type DeliverableSection = CoverSection$1 | ArtifactImageGridSection$1 | ArtifactSpotlightSection$1 | TextBlockSection$1 | ColorPaletteSection$1 | QuoteBlockSection$1;
-interface CoverSection$1 {
-    type: 'COVER';
-    eyebrow?: string | null;
-    title: string;
-    subtitle?: string | null;
-}
-interface ArtifactImageGridSection$1 {
-    type: 'ARTIFACT_IMAGE_GRID';
-    heading?: string | null;
-    /** 1, 2 or 3. */
-    columns: number;
-    items: DeliverableImageItem[];
-}
-interface ArtifactSpotlightSection$1 {
-    type: 'ARTIFACT_SPOTLIGHT';
-    heading?: string | null;
-    artifact: DeliverableArtifactRef;
-    body?: string | null;
-}
-interface TextBlockSection$1 {
-    type: 'TEXT_BLOCK';
-    heading?: string | null;
-    body: string;
-}
-interface ColorPaletteSection$1 {
-    type: 'COLOR_PALETTE';
-    heading?: string | null;
-    swatches: DeliverableSwatch[];
-}
-interface QuoteBlockSection$1 {
-    type: 'QUOTE_BLOCK';
-    quote: string;
-    attribution?: string | null;
-}
-interface DeliverableImageItem {
-    artifact: DeliverableArtifactRef;
-    caption?: string | null;
-}
-interface DeliverableSwatch {
-    color: string;
-    label: string;
-}
-/**
- * Minimal subset of the hypocaust ArtifactDto shape consumed by the renderer.
- * Only the fields needed to render a deliverable's referenced artifacts.
- */
-interface DeliverableArtifactRef {
-    url?: string | null;
-    title?: string | null;
-    description?: string | null;
-}
-
-interface DeliverableRendererProps {
-    /** Resolved deliverable spec — every artifact reference already inflated. */
-    deliverable: Deliverable;
-    /**
-     * Called when the viewer requests a PDF download. The host application is
-     * responsible for fetching and triggering the file save (the URL knows
-     * about share tokens and credentials we don't). When omitted, the download
-     * affordance is hidden.
-     */
-    onDownloadPdf?: () => void | Promise<void>;
-    /** Hide the floating action bar entirely. Used when rendering for print. */
-    hideActions?: boolean;
-    className?: string;
-}
-/**
- * Render a presentable deliverable (moodboard, pitch deck) from a structured
- * spec. The same component drives the on-screen view and the print/PDF
- * version — `@media print` styles in `aurelius/styles/base.css` keep them in
- * sync. To produce a PDF, drive the page with headless Chromium and let the
- * print stylesheet do the work.
- *
- * The renderer is purely presentational: it takes a fully resolved spec
- * (artifact URLs already inflated by the caller) and dispatches each section
- * to its typed sub-renderer. Unknown section types are skipped silently
- * forward-compat for new section variants added by the backend.
- */
-declare function DeliverableRenderer({ deliverable, onDownloadPdf, hideActions, className, }: DeliverableRendererProps): React$1.JSX.Element;
-
-interface CoverSectionProps {
-    data: CoverSection$1;
-    /** Document-level client name from {@link Deliverable.clientName}, shown as "Prepared for {name}". */
-    clientName?: string | null;
-}
-/**
- * Title page for a deliverable. Always rendered as the first section.
- */
-declare function CoverSection({ data, clientName }: CoverSectionProps): React$1.JSX.Element;
-
-interface ArtifactImageGridSectionProps {
-    data: ArtifactImageGridSection$1;
-}
-/**
- * Grid of project artifact images with optional captions. The number of
- * columns is fixed by the spec (1–3); the renderer enforces a sensible aspect
- * ratio per item and lets the browser flow rows.
- */
-declare function ArtifactImageGridSection({ data }: ArtifactImageGridSectionProps): React$1.JSX.Element;
-
-interface ArtifactSpotlightSectionProps {
-    data: ArtifactSpotlightSection$1;
-}
-/**
- * A single hero artifact image with optional prose alongside. Reads at full
- * page width on screen and prints to a single page.
- */
-declare function ArtifactSpotlightSection({ data }: ArtifactSpotlightSectionProps): React$1.JSX.Element;
-
-interface TextBlockSectionProps {
-    data: TextBlockSection$1;
-}
-/**
- * Prose section. Body is rendered as Markdown.
- */
-declare function TextBlockSection({ data }: TextBlockSectionProps): React$1.JSX.Element;
-
-interface ColorPaletteSectionProps {
-    data: ColorPaletteSection$1;
-}
-/**
- * Color palette presented as labelled swatches with hex values.
- */
-declare function ColorPaletteSection({ data }: ColorPaletteSectionProps): React$1.JSX.Element;
-
-interface QuoteBlockSectionProps {
-    data: QuoteBlockSection$1;
+interface TextareaCaretCoords {
+    /** Top of the caret, in pixels relative to the textarea's top-left. */
+    top: number;
+    /** Left of the caret, in pixels relative to the textarea's top-left. */
+    left: number;
+    /** Caret line height in pixels — useful when positioning a popover just above/below. */
+    height: number;
 }
-/**
- * Pulled quote with optional attribution. The renderer adds the surrounding
- * quotation marks.
- */
-declare function QuoteBlockSection({ data }: QuoteBlockSectionProps): React$1.JSX.Element;
+declare function getTextareaCaretCoords(textarea: HTMLTextAreaElement): TextareaCaretCoords;
 
 /**
  * Aurelius Design System
@@ -2507,4 +2831,4 @@ declare function QuoteBlockSection({ data }: QuoteBlockSectionProps): React$1.JS
 
 declare const version = "2.0.0";
 
-export { ARTIFACT_TYPES, Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, 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 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, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerProps, type ContainerSize, type Conversation, type ConversationTree, CoverSection, type CoverSectionProps, CrossSquareIcon, type Deliverable, type DeliverableArtifactRef, type DeliverableImageItem, DeliverableRenderer, type DeliverableRendererProps, type DeliverableSection, type DeliverableSwatch, 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, Input, type InputAddonProps, type InputElementProps, InputGroup, type InputGroupProps, InputLeftAddon, InputLeftElement, type InputProps, InputRightAddon, InputRightElement, InputWrapper, type InputWrapperProps, Label, type LabelProps, LayersIcon, List, ListItem, type ListItemProps, ListItemText, type ListItemTextProps, type ListProps, ListSubheader, type ListSubheaderProps, MarkdownContent, type MarkdownContentProps, MediaIcon, 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, 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 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 UseScrollAnchorOptions, type UseScrollAnchorReturn, type VideoAspectRatio, type VideoAspectRatioPreset, VideoCard, type VideoCardProps, addNodeToTree, areAllTasksSettled, createEmptyTree, createPreviewUrl, findAncestor, generateId, getActivePath, getGreyedFuture, getSiblingInfo, isBranchPoint, isImageFile, messagesToTree, revokePreviewUrl, setActiveLeaf, switchBranch, updateMessageContent, useArtifactTreeNavigation, 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, 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 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, 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, 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, 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 };