@lukeashford/aurelius 4.1.0 → 4.3.0

package/dist/index.d.mts

@@ -195,8 +195,8 @@ interface ListSubheaderProps extends React$1.HTMLAttributes<HTMLLIElement> {
 }
 declare const ListSubheader: React$1.ForwardRefExoticComponent<ListSubheaderProps & React$1.RefAttributes<HTMLLIElement>>;
 
-type FileChipStatus = 'pending' | 'uploading' | 'complete' | 'error';
-interface FileChipProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'children'> {
+type FileChipStatus = 'pending' | 'uploading' | 'uploaded' | 'analyzing' | 'analyzed' | 'upload_failed' | 'analysis_failed';
+interface FileChipProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'children' | 'onClick'> {
     /**
      * File name to display
      */
@@ -226,9 +226,20 @@ interface FileChipProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'ch
      */
     removable?: boolean;
     /**
-     * Error message to display (when status is 'error')
+     * Error message to display (when status is an error)
      */
     error?: string;
+    /**
+     * Backend artifact id, set once the upload has been integrated. When both
+     * `artifactId` and `onOpen` are present, the chip becomes clickable.
+     */
+    artifactId?: string;
+    /**
+     * Click handler invoked with `artifactId` when the chip is clicked.
+     * Compose-box (pre-integrate) chips should not pass this — the chip stays
+     * non-clickable except for its remove button.
+     */
+    onOpen?: (artifactId: string) => void;
 }
 declare const FileChip: React$1.ForwardRefExoticComponent<FileChipProps & React$1.RefAttributes<HTMLDivElement>>;
 
@@ -238,9 +249,12 @@ interface AttachmentItem {
      */
     id: string;
     /**
-     * The File object
+     * The file's name, size and MIME type. A real `File` object satisfies this
+     * shape — compose-box callers pass File instances directly. Above-message
+     * (post-send) rendering supplies a synthetic record built from persisted
+     * attachment metadata.
      */
-    file: File;
+    file: Pick<File, 'name' | 'size' | 'type'>;
     /**
      * Blob URL for image previews
      */
@@ -250,9 +264,14 @@ interface AttachmentItem {
      */
     status: FileChipStatus;
     /**
-     * Error message if status is 'error'
+     * Error message if status is an error variant
      */
     error?: string;
+    /**
+     * Backend artifact id, set once the upload has been integrated. Required to
+     * make the chip clickable to open the artifact card modal.
+     */
+    artifactId?: string;
 }
 interface AttachmentPreviewProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /**
@@ -272,6 +291,11 @@ interface AttachmentPreviewProps extends React$1.HTMLAttributes<HTMLDivElement>
      * Set to 0 or undefined to show all
      */
     maxVisible?: number;
+    /**
+     * Click handler for chips with an artifactId. When set, chips that carry an
+     * artifactId become clickable and forward the id to this handler.
+     */
+    onOpen?: (artifactId: string) => void;
 }
 declare const AttachmentPreview: React$1.ForwardRefExoticComponent<AttachmentPreviewProps & React$1.RefAttributes<HTMLDivElement>>;
 
@@ -708,6 +732,16 @@ interface MessageProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'con
      * Whether to hide actions (e.g., during streaming)
      */
     hideActions?: boolean;
+    /**
+     * Attachments to render above the bubble. Used by user messages to show the
+     * files that were attached to that turn. Empty/undefined renders nothing.
+     */
+    attachments?: AttachmentItem[];
+    /**
+     * Click handler invoked with an attachment's `artifactId`. Wire to open the
+     * artifact-card modal in the host app.
+     */
+    onAttachmentOpen?: (artifactId: string) => void;
 }
 declare const Message: React$1.ForwardRefExoticComponent<MessageProps & React$1.RefAttributes<HTMLDivElement>>;
 
@@ -738,20 +772,6 @@ interface MarkdownContentProps extends React$1.HTMLAttributes<HTMLDivElement> {
 }
 declare const MarkdownContent: React$1.ForwardRefExoticComponent<MarkdownContentProps & React$1.RefAttributes<HTMLDivElement>>;
 
-/**
- * Conversation tree types.
- *
- * The chat is rendered from a tree where every fork point — user-edits,
- * retries, parallel task attempts, rewinds — produces siblings under a shared
- * parent. The tree is generic over its node type so that the topology
- * algorithms in `./tree.ts` stay free of any kind-specific branching.
- *
- * Two concrete node kinds live here today: `MessageNode` (a user or assistant
- * turn) and `CheckpointNode` (a marker anchored to a hypocaust task execution
- * that the user can rewind to). New kinds plug in by extending `NodeTopology`
- * and joining the `ChatNode` union.
- */
-
 /**
  * The minimal contract every tree node must satisfy. The tree algorithms only
  * ever read these fields; everything else is opaque to them.
@@ -780,6 +800,39 @@ interface MessageNode extends NodeTopology {
     content: ReactNode;
     /** Whether this message is currently being streamed. */
     isStreaming?: boolean;
+    /**
+     * Files that were attached to this message turn. Rendered as a chip strip
+     * above the bubble. Empty/undefined renders nothing. The `artifactId` field
+     * on each item, paired with the host's `onAttachmentOpen`, drives
+     * click-through to the artifact-card modal.
+     */
+    attachments?: MessageAttachmentItem[];
+}
+/**
+ * One attachment row above a sent user message. Mirrors `AttachmentItem` but
+ * carries the persisted `artifactId` instead of an in-memory File reference,
+ * since these refer to artifacts that already live in the project tree.
+ */
+interface MessageAttachmentItem {
+    /** Stable identifier for the chip (typically the upload or artifact id). */
+    id: string;
+    /** Display name (filename from the original upload). */
+    name: string;
+    /** MIME type — drives the chip icon and image-preview branch. */
+    type: string;
+    /** File size in bytes, optional. */
+    size?: number;
+    /** Pre-signed thumbnail URL for image previews, optional. */
+    previewUrl?: string;
+    /** Backend artifact id; required for click-through to work. */
+    artifactId?: string;
+    /**
+     * Lifecycle state captured at message-build time. Defaults to `analyzed`
+     * for the happy path. Set to `analysis_failed` to render a red chip on a
+     * successfully-integrated message, or to a pre-integrate state on a
+     * message whose integrate call failed.
+     */
+    status?: AttachmentStatus;
 }
 /**
  * A checkpoint that anchors a chat position to a hypocaust task execution.
@@ -799,8 +852,9 @@ interface CheckpointNode extends NodeTopology {
      * - `submit`: a merge of a working branch into the project head
      * - `rename`: a manual artifact rename via the artifacts panel (planned)
      * - `init`: the project head at session start (seeded into new chats)
+     * - `ingest`: a batch of user uploads committed to the project tree
      */
-    executionKind: 'task' | 'submit' | 'rename' | 'init';
+    executionKind: 'task' | 'submit' | 'rename' | 'init' | 'ingest';
     /** Terminal status reported by hypocaust. */
     status: 'completed' | 'failed' | 'cancelled';
 }
@@ -834,9 +888,10 @@ interface ConversationTree<T extends NodeTopology = ChatNode> {
     lastLeafId: string | null;
 }
 /**
- * Attachment types for file uploads
+ * Attachment lifecycle, mirroring the per-file backend state machine:
+ * upload → analyze, with separate failure modes for each phase.
  */
-type AttachmentStatus = 'pending' | 'uploading' | 'complete' | 'error';
+type AttachmentStatus = 'pending' | 'uploading' | 'uploaded' | 'analyzing' | 'analyzed' | 'upload_failed' | 'analysis_failed';
 interface Attachment {
     /**
      * Unique identifier for the attachment
@@ -855,13 +910,18 @@ interface Attachment {
      */
     status: AttachmentStatus;
     /**
-     * Error message if status is 'error'
+     * Error message if status is an error variant
      */
     error?: string;
     /**
      * Upload progress (0-100)
      */
     progress?: number;
+    /**
+     * Backend artifact id, set once the batch is integrated. Drives chip
+     * click-through to the artifact-card modal in the host app.
+     */
+    artifactId?: string;
 }
 /**
  * Helper to check if a file is an image
@@ -1396,6 +1456,13 @@ interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>
      * Typically shown after a user message but before the first streaming token.
      */
     isThinking?: boolean;
+    /**
+     * Optional verbatim label for the thinking indicator. When set, the indicator
+     * suppresses its rotating phrases and renders this string as-is. Use for
+     * domain-specific waits like "Analyzing uploads..." — any animated suffix
+     * (e.g. cycling dots) is the caller's responsibility.
+     */
+    thinkingLabel?: string;
     /**
      * Placeholder text for the main chat input.
      */
@@ -1429,6 +1496,12 @@ interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>
      * Called when an attachment is removed by the user (clicking the "x")
      */
     onAttachmentRemove?: (attachment: Attachment) => void;
+    /**
+     * Called when a chip above a sent message is clicked. Receives the
+     * `artifactId` carried by the chip; wire to open the artifact-card modal.
+     * Without this, above-message chips are not clickable.
+     */
+    onAttachmentOpen?: (artifactId: string) => void;
     /**
      * Top-level artifact tree nodes for the artifacts panel.
      */
@@ -1517,7 +1590,7 @@ declare const ChatInterface: React$1.ForwardRefExoticComponent<ChatInterfaceProp
  * What kind of project mutation produced this checkpoint. Drives the icon and
  * visual emphasis. The label and underlying state are unchanged.
  */
-type CheckpointExecutionKind = 'task' | 'submit' | 'rename' | 'init';
+type CheckpointExecutionKind = 'task' | 'submit' | 'rename' | 'init' | 'ingest';
 /**
  * Terminal state of the underlying execution. `failed` and `cancelled` render
  * with status text and muted accents but stay clickable so the user can still
@@ -1639,6 +1712,12 @@ interface ChatViewProps extends React$1.HTMLAttributes<HTMLDivElement> {
      * Whether to show the thinking indicator (between user message and response).
      */
     isThinking?: boolean;
+    /**
+     * When set, the thinking indicator renders this label verbatim instead of
+     * its rotating phrases. Use for domain-specific waits like
+     * "Analyzing uploads..." (any animated suffix is the caller's responsibility).
+     */
+    thinkingLabel?: string;
     /**
      * Callback when the user scrolls manually.
      */
@@ -1664,6 +1743,19 @@ interface ArtifactsPanelProps extends React$1.HTMLAttributes<HTMLDivElement> {
      * Whether artifacts are still loading (show skeletons)
      */
     loading?: 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.
+     * Pair with `onArtifactClosed` so the parent can clear its controller
+     * state when the user dismisses the modal.
+     */
+    openArtifactId?: string | null;
+    /**
+     * Called when the user closes the expanded card (X button or backdrop).
+     * The parent owns whether subsequent renders re-open by re-supplying
+     * `openArtifactId`.
+     */
+    onArtifactClosed?: () => void;
 }
 /**
  * ArtifactsPanel displays artifacts in a navigable tree panel.
@@ -1807,6 +1899,13 @@ interface ThinkingIndicatorProps extends React$1.HTMLAttributes<HTMLDivElement>
      * Custom phrases to cycle through (defaults to built-in phrases)
      */
     phrases?: string[];
+    /**
+     * When set, suppresses internal phrase rotation and renders this label
+     * verbatim. Used by the host to express domain-specific waiting states
+     * (e.g. "Analyzing uploads..."). Any animated suffix (cycling dots) is the
+     * caller's responsibility — Aurelius renders the string as-is.
+     */
+    manualLabel?: string;
 }
 /**
  * ThinkingIndicator shows an animated state when the assistant is processing a request

package/dist/index.d.ts

@@ -195,8 +195,8 @@ interface ListSubheaderProps extends React$1.HTMLAttributes<HTMLLIElement> {
 }
 declare const ListSubheader: React$1.ForwardRefExoticComponent<ListSubheaderProps & React$1.RefAttributes<HTMLLIElement>>;
 
-type FileChipStatus = 'pending' | 'uploading' | 'complete' | 'error';
-interface FileChipProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'children'> {
+type FileChipStatus = 'pending' | 'uploading' | 'uploaded' | 'analyzing' | 'analyzed' | 'upload_failed' | 'analysis_failed';
+interface FileChipProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'children' | 'onClick'> {
     /**
      * File name to display
      */
@@ -226,9 +226,20 @@ interface FileChipProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'ch
      */
     removable?: boolean;
     /**
-     * Error message to display (when status is 'error')
+     * Error message to display (when status is an error)
      */
     error?: string;
+    /**
+     * Backend artifact id, set once the upload has been integrated. When both
+     * `artifactId` and `onOpen` are present, the chip becomes clickable.
+     */
+    artifactId?: string;
+    /**
+     * Click handler invoked with `artifactId` when the chip is clicked.
+     * Compose-box (pre-integrate) chips should not pass this — the chip stays
+     * non-clickable except for its remove button.
+     */
+    onOpen?: (artifactId: string) => void;
 }
 declare const FileChip: React$1.ForwardRefExoticComponent<FileChipProps & React$1.RefAttributes<HTMLDivElement>>;
 
@@ -238,9 +249,12 @@ interface AttachmentItem {
      */
     id: string;
     /**
-     * The File object
+     * The file's name, size and MIME type. A real `File` object satisfies this
+     * shape — compose-box callers pass File instances directly. Above-message
+     * (post-send) rendering supplies a synthetic record built from persisted
+     * attachment metadata.
      */
-    file: File;
+    file: Pick<File, 'name' | 'size' | 'type'>;
     /**
      * Blob URL for image previews
      */
@@ -250,9 +264,14 @@ interface AttachmentItem {
      */
     status: FileChipStatus;
     /**
-     * Error message if status is 'error'
+     * Error message if status is an error variant
      */
     error?: string;
+    /**
+     * Backend artifact id, set once the upload has been integrated. Required to
+     * make the chip clickable to open the artifact card modal.
+     */
+    artifactId?: string;
 }
 interface AttachmentPreviewProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /**
@@ -272,6 +291,11 @@ interface AttachmentPreviewProps extends React$1.HTMLAttributes<HTMLDivElement>
      * Set to 0 or undefined to show all
      */
     maxVisible?: number;
+    /**
+     * Click handler for chips with an artifactId. When set, chips that carry an
+     * artifactId become clickable and forward the id to this handler.
+     */
+    onOpen?: (artifactId: string) => void;
 }
 declare const AttachmentPreview: React$1.ForwardRefExoticComponent<AttachmentPreviewProps & React$1.RefAttributes<HTMLDivElement>>;
 
@@ -708,6 +732,16 @@ interface MessageProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'con
      * Whether to hide actions (e.g., during streaming)
      */
     hideActions?: boolean;
+    /**
+     * Attachments to render above the bubble. Used by user messages to show the
+     * files that were attached to that turn. Empty/undefined renders nothing.
+     */
+    attachments?: AttachmentItem[];
+    /**
+     * Click handler invoked with an attachment's `artifactId`. Wire to open the
+     * artifact-card modal in the host app.
+     */
+    onAttachmentOpen?: (artifactId: string) => void;
 }
 declare const Message: React$1.ForwardRefExoticComponent<MessageProps & React$1.RefAttributes<HTMLDivElement>>;
 
@@ -738,20 +772,6 @@ interface MarkdownContentProps extends React$1.HTMLAttributes<HTMLDivElement> {
 }
 declare const MarkdownContent: React$1.ForwardRefExoticComponent<MarkdownContentProps & React$1.RefAttributes<HTMLDivElement>>;
 
-/**
- * Conversation tree types.
- *
- * The chat is rendered from a tree where every fork point — user-edits,
- * retries, parallel task attempts, rewinds — produces siblings under a shared
- * parent. The tree is generic over its node type so that the topology
- * algorithms in `./tree.ts` stay free of any kind-specific branching.
- *
- * Two concrete node kinds live here today: `MessageNode` (a user or assistant
- * turn) and `CheckpointNode` (a marker anchored to a hypocaust task execution
- * that the user can rewind to). New kinds plug in by extending `NodeTopology`
- * and joining the `ChatNode` union.
- */
-
 /**
  * The minimal contract every tree node must satisfy. The tree algorithms only
  * ever read these fields; everything else is opaque to them.
@@ -780,6 +800,39 @@ interface MessageNode extends NodeTopology {
     content: ReactNode;
     /** Whether this message is currently being streamed. */
     isStreaming?: boolean;
+    /**
+     * Files that were attached to this message turn. Rendered as a chip strip
+     * above the bubble. Empty/undefined renders nothing. The `artifactId` field
+     * on each item, paired with the host's `onAttachmentOpen`, drives
+     * click-through to the artifact-card modal.
+     */
+    attachments?: MessageAttachmentItem[];
+}
+/**
+ * One attachment row above a sent user message. Mirrors `AttachmentItem` but
+ * carries the persisted `artifactId` instead of an in-memory File reference,
+ * since these refer to artifacts that already live in the project tree.
+ */
+interface MessageAttachmentItem {
+    /** Stable identifier for the chip (typically the upload or artifact id). */
+    id: string;
+    /** Display name (filename from the original upload). */
+    name: string;
+    /** MIME type — drives the chip icon and image-preview branch. */
+    type: string;
+    /** File size in bytes, optional. */
+    size?: number;
+    /** Pre-signed thumbnail URL for image previews, optional. */
+    previewUrl?: string;
+    /** Backend artifact id; required for click-through to work. */
+    artifactId?: string;
+    /**
+     * Lifecycle state captured at message-build time. Defaults to `analyzed`
+     * for the happy path. Set to `analysis_failed` to render a red chip on a
+     * successfully-integrated message, or to a pre-integrate state on a
+     * message whose integrate call failed.
+     */
+    status?: AttachmentStatus;
 }
 /**
  * A checkpoint that anchors a chat position to a hypocaust task execution.
@@ -799,8 +852,9 @@ interface CheckpointNode extends NodeTopology {
      * - `submit`: a merge of a working branch into the project head
      * - `rename`: a manual artifact rename via the artifacts panel (planned)
      * - `init`: the project head at session start (seeded into new chats)
+     * - `ingest`: a batch of user uploads committed to the project tree
      */
-    executionKind: 'task' | 'submit' | 'rename' | 'init';
+    executionKind: 'task' | 'submit' | 'rename' | 'init' | 'ingest';
     /** Terminal status reported by hypocaust. */
     status: 'completed' | 'failed' | 'cancelled';
 }
@@ -834,9 +888,10 @@ interface ConversationTree<T extends NodeTopology = ChatNode> {
     lastLeafId: string | null;
 }
 /**
- * Attachment types for file uploads
+ * Attachment lifecycle, mirroring the per-file backend state machine:
+ * upload → analyze, with separate failure modes for each phase.
  */
-type AttachmentStatus = 'pending' | 'uploading' | 'complete' | 'error';
+type AttachmentStatus = 'pending' | 'uploading' | 'uploaded' | 'analyzing' | 'analyzed' | 'upload_failed' | 'analysis_failed';
 interface Attachment {
     /**
      * Unique identifier for the attachment
@@ -855,13 +910,18 @@ interface Attachment {
      */
     status: AttachmentStatus;
     /**
-     * Error message if status is 'error'
+     * Error message if status is an error variant
      */
     error?: string;
     /**
      * Upload progress (0-100)
      */
     progress?: number;
+    /**
+     * Backend artifact id, set once the batch is integrated. Drives chip
+     * click-through to the artifact-card modal in the host app.
+     */
+    artifactId?: string;
 }
 /**
  * Helper to check if a file is an image
@@ -1396,6 +1456,13 @@ interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>
      * Typically shown after a user message but before the first streaming token.
      */
     isThinking?: boolean;
+    /**
+     * Optional verbatim label for the thinking indicator. When set, the indicator
+     * suppresses its rotating phrases and renders this string as-is. Use for
+     * domain-specific waits like "Analyzing uploads..." — any animated suffix
+     * (e.g. cycling dots) is the caller's responsibility.
+     */
+    thinkingLabel?: string;
     /**
      * Placeholder text for the main chat input.
      */
@@ -1429,6 +1496,12 @@ interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>
      * Called when an attachment is removed by the user (clicking the "x")
      */
     onAttachmentRemove?: (attachment: Attachment) => void;
+    /**
+     * Called when a chip above a sent message is clicked. Receives the
+     * `artifactId` carried by the chip; wire to open the artifact-card modal.
+     * Without this, above-message chips are not clickable.
+     */
+    onAttachmentOpen?: (artifactId: string) => void;
     /**
      * Top-level artifact tree nodes for the artifacts panel.
      */
@@ -1517,7 +1590,7 @@ declare const ChatInterface: React$1.ForwardRefExoticComponent<ChatInterfaceProp
  * What kind of project mutation produced this checkpoint. Drives the icon and
  * visual emphasis. The label and underlying state are unchanged.
  */
-type CheckpointExecutionKind = 'task' | 'submit' | 'rename' | 'init';
+type CheckpointExecutionKind = 'task' | 'submit' | 'rename' | 'init' | 'ingest';
 /**
  * Terminal state of the underlying execution. `failed` and `cancelled` render
  * with status text and muted accents but stay clickable so the user can still
@@ -1639,6 +1712,12 @@ interface ChatViewProps extends React$1.HTMLAttributes<HTMLDivElement> {
      * Whether to show the thinking indicator (between user message and response).
      */
     isThinking?: boolean;
+    /**
+     * When set, the thinking indicator renders this label verbatim instead of
+     * its rotating phrases. Use for domain-specific waits like
+     * "Analyzing uploads..." (any animated suffix is the caller's responsibility).
+     */
+    thinkingLabel?: string;
     /**
      * Callback when the user scrolls manually.
      */
@@ -1664,6 +1743,19 @@ interface ArtifactsPanelProps extends React$1.HTMLAttributes<HTMLDivElement> {
      * Whether artifacts are still loading (show skeletons)
      */
     loading?: 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.
+     * Pair with `onArtifactClosed` so the parent can clear its controller
+     * state when the user dismisses the modal.
+     */
+    openArtifactId?: string | null;
+    /**
+     * Called when the user closes the expanded card (X button or backdrop).
+     * The parent owns whether subsequent renders re-open by re-supplying
+     * `openArtifactId`.
+     */
+    onArtifactClosed?: () => void;
 }
 /**
  * ArtifactsPanel displays artifacts in a navigable tree panel.
@@ -1807,6 +1899,13 @@ interface ThinkingIndicatorProps extends React$1.HTMLAttributes<HTMLDivElement>
      * Custom phrases to cycle through (defaults to built-in phrases)
      */
     phrases?: string[];
+    /**
+     * When set, suppresses internal phrase rotation and renders this label
+     * verbatim. Used by the host to express domain-specific waiting states
+     * (e.g. "Analyzing uploads..."). Any animated suffix (cycling dots) is the
+     * caller's responsibility — Aurelius renders the string as-is.
+     */
+    manualLabel?: string;
 }
 /**
  * ThinkingIndicator shows an animated state when the assistant is processing a request