@athenaintel/react 0.6.6 → 0.7.1

package/dist/index.d.ts

@@ -263,6 +263,32 @@ export declare function CollapsibleContent({ ...props }: React.ComponentProps<ty
 
 export declare function CollapsibleTrigger({ ...props }: React.ComponentProps<typeof Collapsible_2.CollapsibleTrigger>): JSX.Element;
 
+/**
+ * Wraps the composer area with drag-and-drop file upload support.
+ * Shows a visual drop indicator when files are dragged over.
+ */
+export declare const ComposerDropZone: FC<ComposerDropZoneProps>;
+
+export declare interface ComposerDropZoneProps {
+    children: ReactNode;
+    className?: string;
+    /** Called after files are uploaded via drag-and-drop. */
+    onUpload?: (assets: UploadedAsset[]) => void;
+}
+
+/**
+ * Renders a quote preview pill above the composer when text has been quoted
+ * (via Cmd+L, text selection, or PostMessage from an iframe).
+ *
+ * Shows the quoted text with source attribution and a dismiss button.
+ * Clears automatically after message send (handled by ComposerWithQuote).
+ */
+export declare const ComposerQuotePreview: FC<ComposerQuotePreviewProps>;
+
+export declare interface ComposerQuotePreviewProps {
+    className?: string;
+}
+
 export declare function createAssetToolUI(config: {
     icon: React.ElementType;
     assetType: AssetType;
@@ -284,6 +310,12 @@ export declare const DEFAULT_BACKEND_URL = "https://api.athenaintel.com/api/assi
 
 export declare const EmailSearchToolUI: ToolCallMessagePartComponent;
 
+export declare function ExpandableSection({ label, children, defaultOpen, }: {
+    label?: string;
+    children: React.ReactNode;
+    defaultOpen?: boolean;
+}): JSX.Element;
+
 declare interface FetchState {
     isFetching: boolean;
     hasNextPage: boolean;
@@ -291,6 +323,24 @@ declare interface FetchState {
     meta: unknown;
 }
 
+/**
+ * Paperclip button that opens a file picker and uploads selected files to Athena.
+ * After upload, adds files to the attachment context so they appear as pills
+ * above the composer and get included when the message is sent.
+ */
+export declare const FileUploadButton: FC<FileUploadButtonProps>;
+
+export declare interface FileUploadButtonProps {
+    className?: string;
+    /** Called after files are uploaded successfully. Receives the created assets. */
+    onUpload?: (assets: UploadedAsset[]) => void;
+    /** Accepted file types (MIME pattern). Defaults to all files. */
+    accept?: string;
+}
+
+/** Format a tool name like `create_new_sheet` → "Create New Sheet" */
+export declare function formatToolName(name: string): string;
+
 export declare function getAssetInfo(assetId: string): {
     name: string;
     icon: AssetIconType;
@@ -333,8 +383,29 @@ declare interface MenuItem {
  */
 declare type MenuScope = string;
 
+export declare function normalizeResult(result: unknown): Record<string, unknown> | null;
+
 export declare const OpenAssetToolUI: ToolCallMessagePartComponent;
 
+declare interface QuoteContextValue {
+    quote: QuoteData | null;
+    setQuote: (quote: QuoteData | null) => void;
+    clearQuote: () => void;
+}
+
+export declare interface QuoteData {
+    /** The selected/quoted text. */
+    text: string;
+    /** Title of the source (e.g., asset title, document name). */
+    sourceTitle?: string;
+    /** Asset ID of the source (for attribution). */
+    sourceAssetId?: string;
+    /** Message ID of the source message (when quoting from chat). */
+    sourceMessageId?: string;
+    /** Role of the source message ('assistant' | 'user'). */
+    sourceRole?: string;
+}
+
 export declare const ReadAssetToolUI: ToolCallMessagePartComponent;
 
 export declare function resetAssetAutoOpen(): void;
@@ -538,6 +609,17 @@ export declare const TOOL_UI_REGISTRY: Record<string, ToolCallMessagePartCompone
 
 export { ToolCallMessagePartComponent }
 
+export declare function ToolCard({ icon: Icon, status, title, subtitle, toolName, badge, error, children, }: {
+    icon: React.ElementType;
+    status: ToolStatus;
+    title: string;
+    subtitle?: string;
+    toolName?: string;
+    badge?: string;
+    error?: string | null;
+    children?: React.ReactNode;
+}): JSX.Element;
+
 export declare const ToolFallback: ToolCallMessagePartComponent & {
     Root: typeof ToolFallbackRoot;
     Trigger: typeof ToolFallbackTrigger;
@@ -660,6 +742,8 @@ export declare const Toolkits: {
     readonly PREFERENCES: "preferences_toolkit";
 };
 
+export declare type ToolStatus = "running" | "complete" | "incomplete" | "requires-action";
+
 export declare function Tooltip({ ...props }: React_2.ComponentProps<typeof Tooltip_2.Root>): JSX.Element;
 
 export declare function TooltipContent({ className, sideOffset, children, ...props }: React_2.ComponentProps<typeof Tooltip_2.Content>): JSX.Element;
@@ -675,8 +759,26 @@ export declare function TooltipProvider({ delayDuration, ...props }: React_2.Com
 
 export declare function TooltipTrigger({ ...props }: React_2.ComponentProps<typeof Tooltip_2.Trigger>): JSX.Element;
 
+export declare function truncate(text: string, max: number): string;
+
 export declare function tryParseJson(text: string): Record<string, unknown> | null;
 
+export declare interface UploadedAsset {
+    id: string;
+    title: string;
+    fileName: string;
+    fileSize: number;
+    mediaType: string;
+}
+
+export declare interface UploadProgress {
+    current: number;
+    total: number;
+    fileName: string;
+    /** 0–1 normalized progress for the current file */
+    percent: number;
+}
+
 /**
  * Hook to programmatically append text to the composer.
  *
@@ -731,6 +833,29 @@ export declare function useComposerAttachment(): {
     clear: () => void;
 };
 
+/**
+ * Hook for uploading files to the Athena platform via Agora's `/api/upload/` endpoint.
+ * Files become Athena assets (documents, spreadsheets, PDFs, images, etc.).
+ *
+ * Usage:
+ *   const { upload, isUploading, progress, error } = useFileUpload();
+ *   const assets = await upload(fileList);
+ */
+export declare function useFileUpload(): UseFileUploadReturn;
+
+export declare interface UseFileUploadReturn {
+    /** Upload one or more files to Athena. Returns the created asset(s). */
+    upload: (files: File[]) => Promise<UploadedAsset[]>;
+    /** Whether an upload is currently in progress. */
+    isUploading: boolean;
+    /** Upload progress info (null when idle). */
+    progress: UploadProgress | null;
+    /** Last upload error (null when no error). */
+    error: string | null;
+    /** Clear the error state. */
+    clearError: () => void;
+}
+
 export declare function useMentionSuggestions(tools: MentionTool[]): MentionSuggestionsStore;
 
 /**
@@ -748,6 +873,8 @@ export declare function useMentionSuggestions(tools: MentionTool[]): MentionSugg
  */
 export declare function useParentAuth(): string | null;
 
+export declare function useQuote(): QuoteContextValue;
+
 export declare type ViewMode = 'tabs' | 'tiled';
 
 export declare const WebSearchToolUI: ToolCallMessagePartComponent;