@yourgpt/copilot-sdk 2.1.5-alpha.5 → 2.1.5-alpha.6

package/dist/ui/index.d.cts

@@ -7,7 +7,7 @@ import * as class_variance_authority_types from 'class-variance-authority/types'
 import { VariantProps } from 'class-variance-authority';
 import * as use_stick_to_bottom from 'use-stick-to-bottom';
 import { d as WebSearchResult, f as WebSearchResponse } from '../types-ZguuKEs_.cjs';
-import { a as Thread, c as ThreadStorageAdapter, A as AsyncThreadStorageAdapter } from '../types-waEqyE4K.cjs';
+import { a as Thread, c as ThreadStorageAdapter, A as AsyncThreadStorageAdapter, M as MessageAttachment$1 } from '../types-waEqyE4K.cjs';
 import { T as ToolDefinition } from '../tools-DcS6Aeao.cjs';
 import { B as BranchInfo } from '../MessageTree-Dt9qfJ55.cjs';
 import { d as MCPUIIntent, n as MCPUIFrameProps, M as MCPUIResource } from '../types-B20VCJXL.cjs';
@@ -1521,6 +1521,8 @@ type ChatProps = {
         fallback?: string;
         /** Custom avatar component - when provided, replaces the default avatar */
         component?: React__default.ReactNode;
+        /** Additional className applied to the avatar wrapper (e.g. "!bg-transparent") */
+        className?: string;
     };
     /** Loader variant for typing indicator */
     loaderVariant?: "dots" | "typing" | "wave" | "terminal" | "text-blink" | "text-shimmer" | "loading-dots";
@@ -1535,11 +1537,37 @@ type ChatProps = {
     /** Tooltip text when attachments are disabled */
     attachmentsDisabledTooltip?: string;
     /**
-     * Custom attachment processor (e.g., for cloud storage upload)
-     * If provided, uses this instead of default base64 conversion.
-     * @param file - The file to process
-     * @returns Promise<MessageAttachment> - The processed attachment (URL-based or base64)
+     * File upload handler. Determines how attachments are uploaded.
+     *
+     * - `string` — Server upload URL. Files are POSTed as JSON `{ data, mimeType, filename }`.
+     * - `object` — URL + headers/body options for the upload request.
+     * - `function` — Full custom handler. Receives `File`, returns `MessageAttachment`.
+     * - `undefined` — Falls back to base64 (embedded in message, no upload).
+     *
+     * @example
+     * ```tsx
+     * // Simple — just a URL:
+     * <CopilotChat upload="/api/copilot/upload" />
+     *
+     * // With auth headers:
+     * <CopilotChat upload={{
+     *   url: "/api/copilot/upload",
+     *   headers: () => ({ Authorization: `Bearer ${token}` }),
+     * }} />
+     *
+     * // Full custom:
+     * <CopilotChat upload={async (file) => {
+     *   const url = await myS3Upload(file);
+     *   return { type: 'image', url, mimeType: file.type, filename: file.name };
+     * }} />
+     * ```
      */
+    upload?: string | {
+        url: string;
+        headers?: Record<string, string> | (() => Record<string, string>);
+        body?: Record<string, unknown> | (() => Record<string, unknown>);
+    } | ((file: File) => Promise<MessageAttachment>);
+    /** @deprecated Use `upload` instead */
     processAttachment?: (file: File) => Promise<MessageAttachment>;
     /** Quick reply suggestions */
     suggestions?: string[];
@@ -1894,7 +1922,7 @@ declare function BackButton({ className, children, disabled, "aria-label": ariaL
  */
 type ThreadPickerCompoundProps = Omit<ThreadPickerProps, "value" | "threads" | "onSelect" | "onNewThread" | "onDeleteThread" | "disabled">;
 declare function ThreadPickerCompound(props: ThreadPickerCompoundProps): react_jsx_runtime.JSX.Element | null;
-declare function ChatComponent({ messages, onSendMessage, onStop, isLoading, children, placeholder, welcomeMessage, title, showHeader, header, threadPicker, logo, name, onClose, showPoweredBy, showUserAvatar, userAvatar: userAvatarProp, assistantAvatar: assistantAvatarProp, loaderVariant, fontSize, maxFileSize, allowedFileTypes, attachmentsEnabled, attachmentsDisabledTooltip, processAttachment: processAttachmentProp, suggestions, onSuggestionClick, welcome, recentThreads, onSelectThread, onDeleteThread, onViewMoreThreads, isProcessing, registeredTools, toolRenderers, mcpToolRenderer, fallbackToolRenderer, onApproveToolExecution, onRejectToolExecution, showFollowUps, followUpClassName, followUpButtonClassName, citations, messageView, renderMessage, wrapMessage, renderInput, renderHeader, groupConsecutiveMessages, className, classNames, onNewChat, threads, currentThreadId, onSwitchThread, isThreadBusy, getBranchInfo, onSwitchBranch, onEditMessage, }: ChatProps): react_jsx_runtime.JSX.Element;
+declare function ChatComponent({ messages, onSendMessage, onStop, isLoading, children, placeholder, welcomeMessage, title, showHeader, header, threadPicker, logo, name, onClose, showPoweredBy, showUserAvatar, userAvatar: userAvatarProp, assistantAvatar: assistantAvatarProp, loaderVariant, fontSize, maxFileSize, allowedFileTypes, attachmentsEnabled, attachmentsDisabledTooltip, upload: uploadProp, processAttachment: deprecatedProcessAttachment, suggestions, onSuggestionClick, welcome, recentThreads, onSelectThread, onDeleteThread, onViewMoreThreads, isProcessing, registeredTools, toolRenderers, mcpToolRenderer, fallbackToolRenderer, onApproveToolExecution, onRejectToolExecution, showFollowUps, followUpClassName, followUpButtonClassName, citations, messageView, renderMessage, wrapMessage, renderInput, renderHeader, groupConsecutiveMessages, className, classNames, onNewChat, threads, currentThreadId, onSwitchThread, isThreadBusy, getBranchInfo, onSwitchBranch, onEditMessage, }: ChatProps): react_jsx_runtime.JSX.Element;
 /**
  * Chat component with compound component pattern.
  *
@@ -2433,6 +2461,87 @@ declare function MCPUIFrameList({ resources, onIntent, onError, className, frame
 
 declare function cn(...inputs: ClassValue[]): string;
 
+type AttachmentStatus = "uploading" | "ready" | "error";
+interface PendingAttachment {
+    id: string;
+    file: File;
+    /** Object URL for image preview */
+    preview?: string;
+    status: AttachmentStatus;
+    /** Upload progress 0-100 */
+    progress: number;
+    error?: string;
+    /** Final attachment data when ready */
+    attachment?: MessageAttachment$1;
+}
+type UploadConfig = string | {
+    url: string;
+    headers?: Record<string, string> | (() => Record<string, string>);
+    body?: Record<string, unknown> | (() => Record<string, unknown>);
+} | ((file: File) => Promise<MessageAttachment$1>);
+interface UseAttachmentsConfig {
+    /** Upload handler — string (URL), object (URL+options), or function (custom) */
+    upload?: UploadConfig;
+    /** Maximum number of files (default: 5) */
+    maxFiles?: number;
+    /** Maximum file size in bytes (default: 10MB) */
+    maxFileSize?: number;
+    /** Allowed MIME types (default: images + PDF) */
+    allowedFileTypes?: string[];
+}
+interface UseAttachmentsReturn {
+    /** Current pending attachments */
+    attachments: PendingAttachment[];
+    /** Whether files are being dragged over the drop zone */
+    isDragging: boolean;
+    /** Add files (from file picker or drop) */
+    addFiles: (files: FileList | File[]) => void;
+    /** Remove a pending attachment */
+    removeAttachment: (id: string) => void;
+    /** Cancel an in-progress upload */
+    cancelUpload: (id: string) => void;
+    /** Retry a failed upload */
+    retryUpload: (id: string) => void;
+    /** Clear all attachments */
+    clearAll: () => void;
+    /** Get ready attachments as MessageAttachment[] for sending */
+    getReadyAttachments: () => MessageAttachment$1[];
+    /** Whether any attachments exist */
+    hasAttachments: boolean;
+    /** Whether any upload is in progress */
+    isUploading: boolean;
+    /** Whether message can be sent (has ready attachments, none still uploading) */
+    canSend: boolean;
+    /** Drag-drop event handlers — spread on the container element */
+    dragHandlers: {
+        onDragEnter: (e: React.DragEvent) => void;
+        onDragOver: (e: React.DragEvent) => void;
+        onDragLeave: (e: React.DragEvent) => void;
+        onDrop: (e: React.DragEvent) => void;
+    };
+    /** Open native file picker */
+    openFilePicker: () => void;
+    /** Ref for hidden file input */
+    fileInputRef: React.RefObject<HTMLInputElement | null>;
+    /** Handler for file input change */
+    onFileInputChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
+}
+declare function useAttachments(config?: UseAttachmentsConfig): UseAttachmentsReturn;
+
+interface AttachmentStripProps {
+    attachments: PendingAttachment[];
+    onRemove: (id: string) => void;
+    onRetry: (id: string) => void;
+    className?: string;
+}
+declare function AttachmentStrip({ attachments, onRemove, onRetry, className, }: AttachmentStripProps): react_jsx_runtime.JSX.Element | null;
+
+interface DropZoneOverlayProps {
+    isDragging: boolean;
+    className?: string;
+}
+declare function DropZoneOverlay({ isDragging, className, }: DropZoneOverlayProps): react_jsx_runtime.JSX.Element | null;
+
 /**
  * ChatPrimitives — composable primitives for building custom chat layouts.
  * Must be used inside <CopilotChat>.
@@ -2481,4 +2590,4 @@ declare const ChatPrimitives: {
     Loader: typeof Loader;
 };
 
-export { AlertTriangleIcon, type BackButtonProps, BotIcon, BranchNavigator, type BranchNavigatorProps, Button, CapabilityBadge, type CapabilityBadgeProps, CapabilityList, type CapabilityListProps, type CapabilityType, Chat, ChatContainerContent, ChatContainerRoot, ChatContainerScrollAnchor, type ChatMessage, ChatPrimitives, type ChatProps, type ChatViewProps, ChatWelcome, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronUpIcon, type Citation, CitationBadge, type CitationBadgeProps, type CitationConfig, CitationSuperscript, type CitationSuperscriptProps, type CitationsConfig, CloseIcon, type CloudPersistenceConfig, CodeBlock, CompactPermissionConfirmation, type CompactPermissionConfirmationProps, Confirmation, ConfirmationActions, type ConfirmationActionsProps, ConfirmationApproved, type ConfirmationApprovedProps, ConfirmationMessage, type ConfirmationMessageProps, ConfirmationPending, type ConfirmationPendingProps, type ConfirmationProps, ConfirmationRejected, type ConfirmationRejectedProps, type ConfirmationState$1 as ConfirmationState, ConnectedChat, type ConnectedChatProps, CopilotChat, type CopilotChatClassNames, type CopilotChatPersistenceConfig, type CopilotChatProps, type CopilotUIConfig, type CopilotUIContextValue, CopilotUIProvider, type CopilotUIProviderProps, CopyIcon, DEFAULT_PERMISSION_OPTIONS, DevLogger, type DevLoggerProps, type DevLoggerState, FeedbackBar, type FollowUpProps, FollowUpQuestions, type FooterProps, type HeaderProps, type HomeViewProps as HomeProps, type HomeViewProps, InlineToolSteps, type InlineToolStepsProps, Loader, type LocalPersistenceConfig, MCPUIFrame, MCPUIFrameList, type MCPUIFrameListProps, MCPUIFrameProps, Markdown, MessageAvatar, MessageContent, type MessageListProps, Message as MessagePrimitive, MessageWithCitations, type MessageWithCitationsProps, type ModelOption, ModelSelector, type ModelSelectorProps, PermissionConfirmation, type PermissionConfirmationProps, type PermissionLevel, type PermissionOption, PoweredBy, type PoweredByProps, PromptInput, PromptInputAction, PromptInputActions, PromptInputTextarea, type ProviderGroup, Reasoning, ReasoningContent, type ReasoningContentProps, type ReasoningProps, ReasoningTrigger, type ReasoningTriggerProps, RefreshIcon, ScrollButton, SearchAnswer, type SearchAnswerProps, SearchResults, type SearchResultsProps, SearchResultsWithAnswer, type SearchResultsWithAnswerProps, SendIcon, type ServerPersistenceConfig, SimpleConfirmation, type SimpleConfirmationProps, SimpleModelSelector, type SimpleModelSelectorProps, SimpleReasoning, type SimpleReasoningProps, SimpleSource, type SimpleSourceProps, Source, SourceContent, type SourceContentProps, SourceGroup, type SourceGroupProps, type SourceItem, SourcePill, type SourcePillProps, type SourceProps, SourceTrigger, type SourceTriggerProps, SourcesBar, type SourcesBarProps, SourcesCollapsible, type SourcesCollapsibleProps, SourcesList, type SourcesListProps, StopIcon, ThreadCard, type ThreadCardProps, ThreadList, type ThreadListProps, ThreadPicker, type ThreadPickerCompoundProps, type ThreadPickerProps, ThumbsDownIcon, ThumbsUpIcon, ToolExecutionMessage, type ToolRendererProps, type ToolRenderers, ToolStep, type ToolStepData, type ToolStepProps, type ToolStepStatus, ToolSteps, type ToolStepsProps, Tooltip, TooltipContent, type TooltipContentProps, type TooltipProps, TooltipProvider, type TooltipProviderProps, TooltipTrigger, type TooltipTriggerProps, UserIcon, type WelcomeConfig, XIcon, annotationsToCitations, cn, parseFollowUps, resultsToCitations, useChatContainer, useCopilotChatContext, useCopilotUI };
+export { AlertTriangleIcon, AttachmentStrip, type AttachmentStripProps, type BackButtonProps, BotIcon, BranchNavigator, type BranchNavigatorProps, Button, CapabilityBadge, type CapabilityBadgeProps, CapabilityList, type CapabilityListProps, type CapabilityType, Chat, ChatContainerContent, ChatContainerRoot, ChatContainerScrollAnchor, type ChatMessage, ChatPrimitives, type ChatProps, type ChatViewProps, ChatWelcome, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronUpIcon, type Citation, CitationBadge, type CitationBadgeProps, type CitationConfig, CitationSuperscript, type CitationSuperscriptProps, type CitationsConfig, CloseIcon, type CloudPersistenceConfig, CodeBlock, CompactPermissionConfirmation, type CompactPermissionConfirmationProps, Confirmation, ConfirmationActions, type ConfirmationActionsProps, ConfirmationApproved, type ConfirmationApprovedProps, ConfirmationMessage, type ConfirmationMessageProps, ConfirmationPending, type ConfirmationPendingProps, type ConfirmationProps, ConfirmationRejected, type ConfirmationRejectedProps, type ConfirmationState$1 as ConfirmationState, ConnectedChat, type ConnectedChatProps, CopilotChat, type CopilotChatClassNames, type CopilotChatPersistenceConfig, type CopilotChatProps, type CopilotUIConfig, type CopilotUIContextValue, CopilotUIProvider, type CopilotUIProviderProps, CopyIcon, DEFAULT_PERMISSION_OPTIONS, DevLogger, type DevLoggerProps, type DevLoggerState, DropZoneOverlay, type DropZoneOverlayProps, FeedbackBar, type FollowUpProps, FollowUpQuestions, type FooterProps, type HeaderProps, type HomeViewProps as HomeProps, type HomeViewProps, InlineToolSteps, type InlineToolStepsProps, Loader, type LocalPersistenceConfig, MCPUIFrame, MCPUIFrameList, type MCPUIFrameListProps, MCPUIFrameProps, Markdown, MessageAvatar, MessageContent, type MessageListProps, Message as MessagePrimitive, MessageWithCitations, type MessageWithCitationsProps, type ModelOption, ModelSelector, type ModelSelectorProps, type PendingAttachment, PermissionConfirmation, type PermissionConfirmationProps, type PermissionLevel, type PermissionOption, PoweredBy, type PoweredByProps, PromptInput, PromptInputAction, PromptInputActions, PromptInputTextarea, type ProviderGroup, Reasoning, ReasoningContent, type ReasoningContentProps, type ReasoningProps, ReasoningTrigger, type ReasoningTriggerProps, RefreshIcon, ScrollButton, SearchAnswer, type SearchAnswerProps, SearchResults, type SearchResultsProps, SearchResultsWithAnswer, type SearchResultsWithAnswerProps, SendIcon, type ServerPersistenceConfig, SimpleConfirmation, type SimpleConfirmationProps, SimpleModelSelector, type SimpleModelSelectorProps, SimpleReasoning, type SimpleReasoningProps, SimpleSource, type SimpleSourceProps, Source, SourceContent, type SourceContentProps, SourceGroup, type SourceGroupProps, type SourceItem, SourcePill, type SourcePillProps, type SourceProps, SourceTrigger, type SourceTriggerProps, SourcesBar, type SourcesBarProps, SourcesCollapsible, type SourcesCollapsibleProps, SourcesList, type SourcesListProps, StopIcon, ThreadCard, type ThreadCardProps, ThreadList, type ThreadListProps, ThreadPicker, type ThreadPickerCompoundProps, type ThreadPickerProps, ThumbsDownIcon, ThumbsUpIcon, ToolExecutionMessage, type ToolRendererProps, type ToolRenderers, ToolStep, type ToolStepData, type ToolStepProps, type ToolStepStatus, ToolSteps, type ToolStepsProps, Tooltip, TooltipContent, type TooltipContentProps, type TooltipProps, TooltipProvider, type TooltipProviderProps, TooltipTrigger, type TooltipTriggerProps, type UploadConfig, type UseAttachmentsConfig, type UseAttachmentsReturn, UserIcon, type WelcomeConfig, XIcon, annotationsToCitations, cn, parseFollowUps, resultsToCitations, useAttachments, useChatContainer, useCopilotChatContext, useCopilotUI };

package/dist/ui/index.d.ts

@@ -7,7 +7,7 @@ import * as class_variance_authority_types from 'class-variance-authority/types'
 import { VariantProps } from 'class-variance-authority';
 import * as use_stick_to_bottom from 'use-stick-to-bottom';
 import { d as WebSearchResult, f as WebSearchResponse } from '../types-ZguuKEs_.js';
-import { a as Thread, c as ThreadStorageAdapter, A as AsyncThreadStorageAdapter } from '../types-waEqyE4K.js';
+import { a as Thread, c as ThreadStorageAdapter, A as AsyncThreadStorageAdapter, M as MessageAttachment$1 } from '../types-waEqyE4K.js';
 import { T as ToolDefinition } from '../tools-DcS6Aeao.js';
 import { B as BranchInfo } from '../MessageTree-Clhiv_k2.js';
 import { d as MCPUIIntent, n as MCPUIFrameProps, M as MCPUIResource } from '../types-B20VCJXL.js';
@@ -1521,6 +1521,8 @@ type ChatProps = {
         fallback?: string;
         /** Custom avatar component - when provided, replaces the default avatar */
         component?: React__default.ReactNode;
+        /** Additional className applied to the avatar wrapper (e.g. "!bg-transparent") */
+        className?: string;
     };
     /** Loader variant for typing indicator */
     loaderVariant?: "dots" | "typing" | "wave" | "terminal" | "text-blink" | "text-shimmer" | "loading-dots";
@@ -1535,11 +1537,37 @@ type ChatProps = {
     /** Tooltip text when attachments are disabled */
     attachmentsDisabledTooltip?: string;
     /**
-     * Custom attachment processor (e.g., for cloud storage upload)
-     * If provided, uses this instead of default base64 conversion.
-     * @param file - The file to process
-     * @returns Promise<MessageAttachment> - The processed attachment (URL-based or base64)
+     * File upload handler. Determines how attachments are uploaded.
+     *
+     * - `string` — Server upload URL. Files are POSTed as JSON `{ data, mimeType, filename }`.
+     * - `object` — URL + headers/body options for the upload request.
+     * - `function` — Full custom handler. Receives `File`, returns `MessageAttachment`.
+     * - `undefined` — Falls back to base64 (embedded in message, no upload).
+     *
+     * @example
+     * ```tsx
+     * // Simple — just a URL:
+     * <CopilotChat upload="/api/copilot/upload" />
+     *
+     * // With auth headers:
+     * <CopilotChat upload={{
+     *   url: "/api/copilot/upload",
+     *   headers: () => ({ Authorization: `Bearer ${token}` }),
+     * }} />
+     *
+     * // Full custom:
+     * <CopilotChat upload={async (file) => {
+     *   const url = await myS3Upload(file);
+     *   return { type: 'image', url, mimeType: file.type, filename: file.name };
+     * }} />
+     * ```
      */
+    upload?: string | {
+        url: string;
+        headers?: Record<string, string> | (() => Record<string, string>);
+        body?: Record<string, unknown> | (() => Record<string, unknown>);
+    } | ((file: File) => Promise<MessageAttachment>);
+    /** @deprecated Use `upload` instead */
     processAttachment?: (file: File) => Promise<MessageAttachment>;
     /** Quick reply suggestions */
     suggestions?: string[];
@@ -1894,7 +1922,7 @@ declare function BackButton({ className, children, disabled, "aria-label": ariaL
  */
 type ThreadPickerCompoundProps = Omit<ThreadPickerProps, "value" | "threads" | "onSelect" | "onNewThread" | "onDeleteThread" | "disabled">;
 declare function ThreadPickerCompound(props: ThreadPickerCompoundProps): react_jsx_runtime.JSX.Element | null;
-declare function ChatComponent({ messages, onSendMessage, onStop, isLoading, children, placeholder, welcomeMessage, title, showHeader, header, threadPicker, logo, name, onClose, showPoweredBy, showUserAvatar, userAvatar: userAvatarProp, assistantAvatar: assistantAvatarProp, loaderVariant, fontSize, maxFileSize, allowedFileTypes, attachmentsEnabled, attachmentsDisabledTooltip, processAttachment: processAttachmentProp, suggestions, onSuggestionClick, welcome, recentThreads, onSelectThread, onDeleteThread, onViewMoreThreads, isProcessing, registeredTools, toolRenderers, mcpToolRenderer, fallbackToolRenderer, onApproveToolExecution, onRejectToolExecution, showFollowUps, followUpClassName, followUpButtonClassName, citations, messageView, renderMessage, wrapMessage, renderInput, renderHeader, groupConsecutiveMessages, className, classNames, onNewChat, threads, currentThreadId, onSwitchThread, isThreadBusy, getBranchInfo, onSwitchBranch, onEditMessage, }: ChatProps): react_jsx_runtime.JSX.Element;
+declare function ChatComponent({ messages, onSendMessage, onStop, isLoading, children, placeholder, welcomeMessage, title, showHeader, header, threadPicker, logo, name, onClose, showPoweredBy, showUserAvatar, userAvatar: userAvatarProp, assistantAvatar: assistantAvatarProp, loaderVariant, fontSize, maxFileSize, allowedFileTypes, attachmentsEnabled, attachmentsDisabledTooltip, upload: uploadProp, processAttachment: deprecatedProcessAttachment, suggestions, onSuggestionClick, welcome, recentThreads, onSelectThread, onDeleteThread, onViewMoreThreads, isProcessing, registeredTools, toolRenderers, mcpToolRenderer, fallbackToolRenderer, onApproveToolExecution, onRejectToolExecution, showFollowUps, followUpClassName, followUpButtonClassName, citations, messageView, renderMessage, wrapMessage, renderInput, renderHeader, groupConsecutiveMessages, className, classNames, onNewChat, threads, currentThreadId, onSwitchThread, isThreadBusy, getBranchInfo, onSwitchBranch, onEditMessage, }: ChatProps): react_jsx_runtime.JSX.Element;
 /**
  * Chat component with compound component pattern.
  *
@@ -2433,6 +2461,87 @@ declare function MCPUIFrameList({ resources, onIntent, onError, className, frame
 
 declare function cn(...inputs: ClassValue[]): string;
 
+type AttachmentStatus = "uploading" | "ready" | "error";
+interface PendingAttachment {
+    id: string;
+    file: File;
+    /** Object URL for image preview */
+    preview?: string;
+    status: AttachmentStatus;
+    /** Upload progress 0-100 */
+    progress: number;
+    error?: string;
+    /** Final attachment data when ready */
+    attachment?: MessageAttachment$1;
+}
+type UploadConfig = string | {
+    url: string;
+    headers?: Record<string, string> | (() => Record<string, string>);
+    body?: Record<string, unknown> | (() => Record<string, unknown>);
+} | ((file: File) => Promise<MessageAttachment$1>);
+interface UseAttachmentsConfig {
+    /** Upload handler — string (URL), object (URL+options), or function (custom) */
+    upload?: UploadConfig;
+    /** Maximum number of files (default: 5) */
+    maxFiles?: number;
+    /** Maximum file size in bytes (default: 10MB) */
+    maxFileSize?: number;
+    /** Allowed MIME types (default: images + PDF) */
+    allowedFileTypes?: string[];
+}
+interface UseAttachmentsReturn {
+    /** Current pending attachments */
+    attachments: PendingAttachment[];
+    /** Whether files are being dragged over the drop zone */
+    isDragging: boolean;
+    /** Add files (from file picker or drop) */
+    addFiles: (files: FileList | File[]) => void;
+    /** Remove a pending attachment */
+    removeAttachment: (id: string) => void;
+    /** Cancel an in-progress upload */
+    cancelUpload: (id: string) => void;
+    /** Retry a failed upload */
+    retryUpload: (id: string) => void;
+    /** Clear all attachments */
+    clearAll: () => void;
+    /** Get ready attachments as MessageAttachment[] for sending */
+    getReadyAttachments: () => MessageAttachment$1[];
+    /** Whether any attachments exist */
+    hasAttachments: boolean;
+    /** Whether any upload is in progress */
+    isUploading: boolean;
+    /** Whether message can be sent (has ready attachments, none still uploading) */
+    canSend: boolean;
+    /** Drag-drop event handlers — spread on the container element */
+    dragHandlers: {
+        onDragEnter: (e: React.DragEvent) => void;
+        onDragOver: (e: React.DragEvent) => void;
+        onDragLeave: (e: React.DragEvent) => void;
+        onDrop: (e: React.DragEvent) => void;
+    };
+    /** Open native file picker */
+    openFilePicker: () => void;
+    /** Ref for hidden file input */
+    fileInputRef: React.RefObject<HTMLInputElement | null>;
+    /** Handler for file input change */
+    onFileInputChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
+}
+declare function useAttachments(config?: UseAttachmentsConfig): UseAttachmentsReturn;
+
+interface AttachmentStripProps {
+    attachments: PendingAttachment[];
+    onRemove: (id: string) => void;
+    onRetry: (id: string) => void;
+    className?: string;
+}
+declare function AttachmentStrip({ attachments, onRemove, onRetry, className, }: AttachmentStripProps): react_jsx_runtime.JSX.Element | null;
+
+interface DropZoneOverlayProps {
+    isDragging: boolean;
+    className?: string;
+}
+declare function DropZoneOverlay({ isDragging, className, }: DropZoneOverlayProps): react_jsx_runtime.JSX.Element | null;
+
 /**
  * ChatPrimitives — composable primitives for building custom chat layouts.
  * Must be used inside <CopilotChat>.
@@ -2481,4 +2590,4 @@ declare const ChatPrimitives: {
     Loader: typeof Loader;
 };
 
-export { AlertTriangleIcon, type BackButtonProps, BotIcon, BranchNavigator, type BranchNavigatorProps, Button, CapabilityBadge, type CapabilityBadgeProps, CapabilityList, type CapabilityListProps, type CapabilityType, Chat, ChatContainerContent, ChatContainerRoot, ChatContainerScrollAnchor, type ChatMessage, ChatPrimitives, type ChatProps, type ChatViewProps, ChatWelcome, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronUpIcon, type Citation, CitationBadge, type CitationBadgeProps, type CitationConfig, CitationSuperscript, type CitationSuperscriptProps, type CitationsConfig, CloseIcon, type CloudPersistenceConfig, CodeBlock, CompactPermissionConfirmation, type CompactPermissionConfirmationProps, Confirmation, ConfirmationActions, type ConfirmationActionsProps, ConfirmationApproved, type ConfirmationApprovedProps, ConfirmationMessage, type ConfirmationMessageProps, ConfirmationPending, type ConfirmationPendingProps, type ConfirmationProps, ConfirmationRejected, type ConfirmationRejectedProps, type ConfirmationState$1 as ConfirmationState, ConnectedChat, type ConnectedChatProps, CopilotChat, type CopilotChatClassNames, type CopilotChatPersistenceConfig, type CopilotChatProps, type CopilotUIConfig, type CopilotUIContextValue, CopilotUIProvider, type CopilotUIProviderProps, CopyIcon, DEFAULT_PERMISSION_OPTIONS, DevLogger, type DevLoggerProps, type DevLoggerState, FeedbackBar, type FollowUpProps, FollowUpQuestions, type FooterProps, type HeaderProps, type HomeViewProps as HomeProps, type HomeViewProps, InlineToolSteps, type InlineToolStepsProps, Loader, type LocalPersistenceConfig, MCPUIFrame, MCPUIFrameList, type MCPUIFrameListProps, MCPUIFrameProps, Markdown, MessageAvatar, MessageContent, type MessageListProps, Message as MessagePrimitive, MessageWithCitations, type MessageWithCitationsProps, type ModelOption, ModelSelector, type ModelSelectorProps, PermissionConfirmation, type PermissionConfirmationProps, type PermissionLevel, type PermissionOption, PoweredBy, type PoweredByProps, PromptInput, PromptInputAction, PromptInputActions, PromptInputTextarea, type ProviderGroup, Reasoning, ReasoningContent, type ReasoningContentProps, type ReasoningProps, ReasoningTrigger, type ReasoningTriggerProps, RefreshIcon, ScrollButton, SearchAnswer, type SearchAnswerProps, SearchResults, type SearchResultsProps, SearchResultsWithAnswer, type SearchResultsWithAnswerProps, SendIcon, type ServerPersistenceConfig, SimpleConfirmation, type SimpleConfirmationProps, SimpleModelSelector, type SimpleModelSelectorProps, SimpleReasoning, type SimpleReasoningProps, SimpleSource, type SimpleSourceProps, Source, SourceContent, type SourceContentProps, SourceGroup, type SourceGroupProps, type SourceItem, SourcePill, type SourcePillProps, type SourceProps, SourceTrigger, type SourceTriggerProps, SourcesBar, type SourcesBarProps, SourcesCollapsible, type SourcesCollapsibleProps, SourcesList, type SourcesListProps, StopIcon, ThreadCard, type ThreadCardProps, ThreadList, type ThreadListProps, ThreadPicker, type ThreadPickerCompoundProps, type ThreadPickerProps, ThumbsDownIcon, ThumbsUpIcon, ToolExecutionMessage, type ToolRendererProps, type ToolRenderers, ToolStep, type ToolStepData, type ToolStepProps, type ToolStepStatus, ToolSteps, type ToolStepsProps, Tooltip, TooltipContent, type TooltipContentProps, type TooltipProps, TooltipProvider, type TooltipProviderProps, TooltipTrigger, type TooltipTriggerProps, UserIcon, type WelcomeConfig, XIcon, annotationsToCitations, cn, parseFollowUps, resultsToCitations, useChatContainer, useCopilotChatContext, useCopilotUI };
+export { AlertTriangleIcon, AttachmentStrip, type AttachmentStripProps, type BackButtonProps, BotIcon, BranchNavigator, type BranchNavigatorProps, Button, CapabilityBadge, type CapabilityBadgeProps, CapabilityList, type CapabilityListProps, type CapabilityType, Chat, ChatContainerContent, ChatContainerRoot, ChatContainerScrollAnchor, type ChatMessage, ChatPrimitives, type ChatProps, type ChatViewProps, ChatWelcome, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronUpIcon, type Citation, CitationBadge, type CitationBadgeProps, type CitationConfig, CitationSuperscript, type CitationSuperscriptProps, type CitationsConfig, CloseIcon, type CloudPersistenceConfig, CodeBlock, CompactPermissionConfirmation, type CompactPermissionConfirmationProps, Confirmation, ConfirmationActions, type ConfirmationActionsProps, ConfirmationApproved, type ConfirmationApprovedProps, ConfirmationMessage, type ConfirmationMessageProps, ConfirmationPending, type ConfirmationPendingProps, type ConfirmationProps, ConfirmationRejected, type ConfirmationRejectedProps, type ConfirmationState$1 as ConfirmationState, ConnectedChat, type ConnectedChatProps, CopilotChat, type CopilotChatClassNames, type CopilotChatPersistenceConfig, type CopilotChatProps, type CopilotUIConfig, type CopilotUIContextValue, CopilotUIProvider, type CopilotUIProviderProps, CopyIcon, DEFAULT_PERMISSION_OPTIONS, DevLogger, type DevLoggerProps, type DevLoggerState, DropZoneOverlay, type DropZoneOverlayProps, FeedbackBar, type FollowUpProps, FollowUpQuestions, type FooterProps, type HeaderProps, type HomeViewProps as HomeProps, type HomeViewProps, InlineToolSteps, type InlineToolStepsProps, Loader, type LocalPersistenceConfig, MCPUIFrame, MCPUIFrameList, type MCPUIFrameListProps, MCPUIFrameProps, Markdown, MessageAvatar, MessageContent, type MessageListProps, Message as MessagePrimitive, MessageWithCitations, type MessageWithCitationsProps, type ModelOption, ModelSelector, type ModelSelectorProps, type PendingAttachment, PermissionConfirmation, type PermissionConfirmationProps, type PermissionLevel, type PermissionOption, PoweredBy, type PoweredByProps, PromptInput, PromptInputAction, PromptInputActions, PromptInputTextarea, type ProviderGroup, Reasoning, ReasoningContent, type ReasoningContentProps, type ReasoningProps, ReasoningTrigger, type ReasoningTriggerProps, RefreshIcon, ScrollButton, SearchAnswer, type SearchAnswerProps, SearchResults, type SearchResultsProps, SearchResultsWithAnswer, type SearchResultsWithAnswerProps, SendIcon, type ServerPersistenceConfig, SimpleConfirmation, type SimpleConfirmationProps, SimpleModelSelector, type SimpleModelSelectorProps, SimpleReasoning, type SimpleReasoningProps, SimpleSource, type SimpleSourceProps, Source, SourceContent, type SourceContentProps, SourceGroup, type SourceGroupProps, type SourceItem, SourcePill, type SourcePillProps, type SourceProps, SourceTrigger, type SourceTriggerProps, SourcesBar, type SourcesBarProps, SourcesCollapsible, type SourcesCollapsibleProps, SourcesList, type SourcesListProps, StopIcon, ThreadCard, type ThreadCardProps, ThreadList, type ThreadListProps, ThreadPicker, type ThreadPickerCompoundProps, type ThreadPickerProps, ThumbsDownIcon, ThumbsUpIcon, ToolExecutionMessage, type ToolRendererProps, type ToolRenderers, ToolStep, type ToolStepData, type ToolStepProps, type ToolStepStatus, ToolSteps, type ToolStepsProps, Tooltip, TooltipContent, type TooltipContentProps, type TooltipProps, TooltipProvider, type TooltipProviderProps, TooltipTrigger, type TooltipTriggerProps, type UploadConfig, type UseAttachmentsConfig, type UseAttachmentsReturn, UserIcon, type WelcomeConfig, XIcon, annotationsToCitations, cn, parseFollowUps, resultsToCitations, useAttachments, useChatContainer, useCopilotChatContext, useCopilotUI };