@yourgpt/copilot-sdk 2.1.5-alpha.1 → 2.1.5-alpha.3

package/dist/ui/index.d.cts

@@ -8,62 +8,11 @@ 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-BeFBBZ5i.cjs';
-import { T as ToolDefinition } from '../tools-DHZhF5km.cjs';
+import { T as ToolDefinition } from '../tools-tmksfhUo.cjs';
 import { B as BranchInfo } from '../MessageTree-CoIt_4nB.cjs';
 import { d as MCPUIIntent, n as MCPUIFrameProps, M as MCPUIResource } from '../types-B20VCJXL.cjs';
 import { ClassValue } from 'clsx';
 
-interface LoaderProps {
-    variant?: "dots" | "typing" | "wave" | "terminal" | "text-blink" | "text-shimmer" | "loading-dots";
-    size?: "sm" | "md" | "lg";
-    text?: string;
-    className?: string;
-}
-declare function Loader({ variant, size, text, className, }: LoaderProps): react_jsx_runtime.JSX.Element;
-
-type MarkdownProps = {
-    children: string;
-    id?: string;
-    className?: string;
-    isStreaming?: boolean;
-    /** Link safety modal configuration. Disabled by default. */
-    linkSafety?: LinkSafetyConfig;
-};
-declare function MarkdownComponent({ children, className, isStreaming, linkSafety, }: MarkdownProps): react_jsx_runtime.JSX.Element;
-declare const Markdown: React$1.MemoExoticComponent<typeof MarkdownComponent>;
-
-type CodeBlockProps = {
-    children?: React__default.ReactNode;
-    className?: string;
-} & React__default.HTMLProps<HTMLDivElement>;
-declare function CodeBlock({ children, className, ...props }: CodeBlockProps): react_jsx_runtime.JSX.Element;
-
-declare const buttonVariants: (props?: ({
-    variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
-    size?: "sm" | "lg" | "default" | "icon" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-interface ButtonProps extends React$1.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
-    asChild?: boolean;
-}
-declare const Button: React$1.ForwardRefExoticComponent<ButtonProps & React$1.RefAttributes<HTMLButtonElement>>;
-
-type FeedbackBarProps = {
-    className?: string;
-    title?: string;
-    icon?: React.ReactNode;
-    onHelpful?: () => void;
-    onNotHelpful?: () => void;
-    onClose?: () => void;
-};
-declare function FeedbackBar({ className, title, icon, onHelpful, onNotHelpful, onClose, }: FeedbackBarProps): react_jsx_runtime.JSX.Element;
-
-type ScrollButtonProps = {
-    className?: string;
-    variant?: VariantProps<typeof buttonVariants>["variant"];
-    size?: VariantProps<typeof buttonVariants>["size"];
-} & React.ButtonHTMLAttributes<HTMLButtonElement>;
-declare function ScrollButton({ className, variant, size, ...props }: ScrollButtonProps): react_jsx_runtime.JSX.Element;
-
 type TooltipProviderProps = {
     children: React__default.ReactNode;
     delayDuration?: number;
@@ -92,6 +41,17 @@ type TooltipContentProps = {
 };
 declare function TooltipContent({ children, className, side, align, sideOffset, showArrow, }: TooltipContentProps): react_jsx_runtime.JSX.Element;
 
+type MarkdownProps = {
+    children: string;
+    id?: string;
+    className?: string;
+    isStreaming?: boolean;
+    /** Link safety modal configuration. Disabled by default. */
+    linkSafety?: LinkSafetyConfig;
+};
+declare function MarkdownComponent({ children, className, isStreaming, linkSafety, }: MarkdownProps): react_jsx_runtime.JSX.Element;
+declare const Markdown: React$1.MemoExoticComponent<typeof MarkdownComponent>;
+
 type MessageProps = {
     children: React.ReactNode;
     className?: string;
@@ -120,6 +80,56 @@ type MessageContentProps = {
     size?: "sm" | "base" | "lg";
 } & React.ComponentProps<typeof Markdown> & Omit<React.HTMLProps<HTMLDivElement>, "size">;
 declare const MessageContent: ({ children, markdown, className, size, ...props }: MessageContentProps) => react_jsx_runtime.JSX.Element;
+type MessageActionsProps$1 = {
+    children: React.ReactNode;
+    className?: string;
+} & React.HTMLProps<HTMLDivElement>;
+type MessageActionProps = {
+    className?: string;
+    tooltip: React.ReactNode;
+    children: React.ReactNode;
+    side?: "top" | "bottom" | "left" | "right";
+} & React.ComponentProps<typeof Tooltip>;
+
+interface LoaderProps {
+    variant?: "dots" | "typing" | "wave" | "terminal" | "text-blink" | "text-shimmer" | "loading-dots";
+    size?: "sm" | "md" | "lg";
+    text?: string;
+    className?: string;
+}
+declare function Loader({ variant, size, text, className, }: LoaderProps): react_jsx_runtime.JSX.Element;
+
+type CodeBlockProps = {
+    children?: React__default.ReactNode;
+    className?: string;
+} & React__default.HTMLProps<HTMLDivElement>;
+declare function CodeBlock({ children, className, ...props }: CodeBlockProps): react_jsx_runtime.JSX.Element;
+
+declare const buttonVariants: (props?: ({
+    variant?: "default" | "link" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
+    size?: "default" | "sm" | "lg" | "icon" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface ButtonProps extends React$1.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
+    asChild?: boolean;
+}
+declare const Button: React$1.ForwardRefExoticComponent<ButtonProps & React$1.RefAttributes<HTMLButtonElement>>;
+
+type FeedbackBarProps = {
+    className?: string;
+    title?: string;
+    icon?: React.ReactNode;
+    onHelpful?: () => void;
+    onNotHelpful?: () => void;
+    onClose?: () => void;
+};
+declare function FeedbackBar({ className, title, icon, onHelpful, onNotHelpful, onClose, }: FeedbackBarProps): react_jsx_runtime.JSX.Element;
+
+type ScrollButtonProps = {
+    className?: string;
+    variant?: VariantProps<typeof buttonVariants>["variant"];
+    size?: VariantProps<typeof buttonVariants>["size"];
+} & React.ButtonHTMLAttributes<HTMLButtonElement>;
+declare function ScrollButton({ className, variant, size, ...props }: ScrollButtonProps): react_jsx_runtime.JSX.Element;
 
 declare const Textarea: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.TextareaHTMLAttributes<HTMLTextAreaElement>, HTMLTextAreaElement>, "ref"> & React$1.RefAttributes<HTMLTextAreaElement>>;
 
@@ -742,83 +752,30 @@ interface SimpleConfirmationProps {
  */
 declare function SimpleConfirmation({ state, message, onApprove, onReject, rejectLabel, approveLabel, className, }: SimpleConfirmationProps): react_jsx_runtime.JSX.Element;
 
-/**
- * Permission level for tool execution
- */
 type PermissionLevel = "ask" | "allow_always" | "deny_always" | "session";
-/**
- * Permission option for dropdown/selection
- */
 interface PermissionOption {
     value: PermissionLevel;
     label: string;
     description?: string;
 }
-/**
- * Default permission options
- */
 declare const DEFAULT_PERMISSION_OPTIONS: PermissionOption[];
 type ConfirmationState = "pending" | "approved" | "rejected";
 interface PermissionConfirmationProps {
-    /** Current state: pending, approved, or rejected */
     state: ConfirmationState;
-    /** Tool name */
     toolName?: string;
-    /** Message to display */
     message?: string;
-    /** Called when user approves with permission level */
     onApprove?: (permissionLevel: PermissionLevel) => void;
-    /** Called when user rejects with permission level */
     onReject?: (permissionLevel?: PermissionLevel) => void;
-    /** Show permission options (default: true) */
-    showPermissionOptions?: boolean;
-    /** Available permission options */
-    permissionOptions?: PermissionOption[];
-    /** Additional class name */
     className?: string;
 }
-/**
- * PermissionConfirmation - Enhanced confirmation with permission level selection
- *
- * Shows a confirmation dialog for tool approval with options to remember the choice.
- *
- * @example
- * ```tsx
- * <PermissionConfirmation
- *   state="pending"
- *   toolName="capture_screenshot"
- *   message="Take a screenshot of the current screen?"
- *   onApprove={(level) => approveToolExecution(tool.id, level)}
- *   onReject={(level) => rejectToolExecution(tool.id, undefined, level)}
- * />
- * ```
- */
-declare function PermissionConfirmation({ state, toolName, message, onApprove, onReject, showPermissionOptions, permissionOptions, className, }: PermissionConfirmationProps): react_jsx_runtime.JSX.Element;
+declare function PermissionConfirmation({ state, toolName, message, onApprove, onReject, className, }: PermissionConfirmationProps): react_jsx_runtime.JSX.Element;
 interface CompactPermissionConfirmationProps {
-    /** Current state: pending, approved, or rejected */
     state: ConfirmationState;
-    /** Message to display */
     message?: string;
-    /** Called when user approves */
     onApprove?: (permissionLevel: PermissionLevel) => void;
-    /** Called when user rejects */
     onReject?: (permissionLevel?: PermissionLevel) => void;
-    /** Additional class name */
     className?: string;
 }
-/**
- * CompactPermissionConfirmation - Simpler version with "Don't ask again" checkbox
- *
- * @example
- * ```tsx
- * <CompactPermissionConfirmation
- *   state="pending"
- *   message="Take a screenshot?"
- *   onApprove={(level) => approveToolExecution(tool.id, level)}
- *   onReject={(level) => rejectToolExecution(tool.id, undefined, level)}
- * />
- * ```
- */
 declare function CompactPermissionConfirmation({ state, message, onApprove, onReject, className, }: CompactPermissionConfirmationProps): react_jsx_runtime.JSX.Element;
 
 type FollowUpProps = {
@@ -1299,6 +1256,8 @@ interface ToolExecutionData {
     duration?: number;
     /** Approval status for human-in-the-loop tools */
     approvalStatus?: ToolApprovalStatus;
+    /** Title shown in approval UI */
+    approvalTitle?: string;
     /** Message shown in approval UI */
     approvalMessage?: string;
     /** Data passed from user's approval action (e.g., selected item) */
@@ -1440,6 +1399,10 @@ interface ToolRendererProps {
         error?: string;
         /** Approval status for tools requiring confirmation */
         approvalStatus?: ToolApprovalStatus;
+        /** Title shown in approval UI */
+        approvalTitle?: string;
+        /** Message shown in approval UI */
+        approvalMessage?: string;
         /** Data passed from user's approval action */
         approvalData?: Record<string, unknown>;
         /** Tool source (mcp, native, custom) - useful for MCP tool identification */
@@ -1659,6 +1622,37 @@ type ChatProps = {
     onApproveToolExecution?: (executionId: string, extraData?: Record<string, unknown>, permissionLevel?: PermissionLevel) => void;
     /** Called when user rejects a tool execution */
     onRejectToolExecution?: (executionId: string, reason?: string, permissionLevel?: PermissionLevel) => void;
+    /**
+     * Custom message list view.
+     * Gives full control over how the message list is rendered.
+     * Receives pre-rendered `messageElements` (default SDK output) and raw `messages`
+     * so you can inject custom UI, reorder, or conditionally replace messages.
+     *
+     * @example
+     * ```tsx
+     * <CopilotChat
+     *   messageView={{
+     *     children: ({ messageElements, messages }) => (
+     *       <>
+     *         {messages.map((msg, i) =>
+     *           msg.metadata?.type === "plan"
+     *             ? <PlanCard key={msg.id} data={msg.metadata} />
+     *             : messageElements[i]
+     *         )}
+     *       </>
+     *     )
+     *   }}
+     * />
+     * ```
+     */
+    messageView?: {
+        children?: (props: {
+            /** Raw messages array */
+            messages: ChatMessage[];
+            /** Pre-rendered message elements (default SDK rendering) */
+            messageElements: React__default.ReactNode[];
+        }) => React__default.ReactNode;
+    };
     /** Custom message renderer */
     renderMessage?: (message: ChatMessage, index: number) => React__default.ReactNode;
     /** Custom input renderer (replaces entire input area) */
@@ -1717,6 +1711,76 @@ type ChatProps = {
     onEditMessage?: (messageId: string, newContent: string) => void;
 };
 
+interface CopyActionProps {
+    tooltip?: string;
+    className?: string;
+}
+/** Built-in copy-to-clipboard action. Use inside CopilotChat.MessageActions. */
+declare function CopyAction({ tooltip, className }: CopyActionProps): null;
+declare namespace CopyAction {
+    var displayName: string;
+}
+interface EditActionProps {
+    tooltip?: string;
+    className?: string;
+}
+/** Built-in edit action for user messages. Use inside CopilotChat.MessageActions role="user". */
+declare function EditAction({ tooltip, className }: EditActionProps): null;
+declare namespace EditAction {
+    var displayName: string;
+}
+interface FeedbackActionProps {
+    onFeedback?: (message: ChatMessage, type: "helpful" | "not-helpful") => void;
+    tooltip?: string;
+    className?: string;
+}
+/** Built-in thumbs up/down feedback action. Use inside CopilotChat.MessageActions. */
+declare function FeedbackAction({ onFeedback, tooltip, className, }: FeedbackActionProps): null;
+declare namespace FeedbackAction {
+    var displayName: string;
+}
+interface ActionProps {
+    id?: string;
+    icon: React__default.ReactNode;
+    tooltip: string;
+    onClick: (props: {
+        message: ChatMessage;
+    }) => void;
+    hidden?: boolean | ((props: {
+        message: ChatMessage;
+    }) => boolean);
+    className?: string;
+}
+/** Custom action button. Use inside CopilotChat.MessageActions. */
+declare function Action({ icon, tooltip, onClick, hidden, className, }: ActionProps): null;
+declare namespace Action {
+    var displayName: string;
+}
+interface MessageActionsProps {
+    role: "user" | "assistant";
+    children?: React__default.ReactNode;
+}
+/**
+ * Registers message actions for a specific role.
+ * Place inside <CopilotChat> as a direct child.
+ *
+ * @example
+ * ```tsx
+ * <CopilotChat>
+ *   <CopilotChat.MessageActions role="assistant">
+ *     <CopilotChat.CopyAction />
+ *     <CopilotChat.FeedbackAction onFeedback={(msg, type) => log(type)} />
+ *     <CopilotChat.Action icon={<ShareIcon />} tooltip="Share" onClick={({ message }) => share(message)} />
+ *   </CopilotChat.MessageActions>
+ *
+ *   <CopilotChat.MessageActions role="user">
+ *     <CopilotChat.EditAction />
+ *   </CopilotChat.MessageActions>
+ * </CopilotChat>
+ * ```
+ */
+declare function MessageActions({ role, children }: MessageActionsProps): null;
+
 interface CopilotChatInternalContext {
     view: "home" | "chat";
     send: (message: string, attachments?: MessageAttachment[]) => void;
@@ -1724,6 +1788,8 @@ interface CopilotChatInternalContext {
     onStop?: () => void;
     attachmentsEnabled: boolean;
     placeholder: string;
+    messages: ChatMessage[];
+    registeredTools?: ToolDefinition[];
     onNewChat?: () => void;
     threads?: Thread[];
     currentThreadId?: string | null;
@@ -1825,7 +1891,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, renderMessage, 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, processAttachment: processAttachmentProp, suggestions, onSuggestionClick, welcome, recentThreads, onSelectThread, onDeleteThread, onViewMoreThreads, isProcessing, registeredTools, toolRenderers, mcpToolRenderer, fallbackToolRenderer, onApproveToolExecution, onRejectToolExecution, showFollowUps, followUpClassName, followUpButtonClassName, citations, messageView, renderMessage, 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.
  *
@@ -1884,8 +1950,56 @@ declare const Chat: typeof ChatComponent & {
     Suggestions: typeof SuggestionsCompound;
     BackButton: typeof BackButton;
     ThreadPicker: typeof ThreadPickerCompound;
+    MessageActions: typeof MessageActions;
+    CopyAction: typeof CopyAction;
+    EditAction: typeof EditAction;
+    FeedbackAction: typeof FeedbackAction;
+    Action: typeof Action;
 };
 
+interface MessageListProps {
+    /**
+     * Render function called for each message.
+     * Return your own component or fall back to <Chat.DefaultMessage />.
+     *
+     * @example
+     * ```tsx
+     * <Chat.MessageList>
+     *   {(message) =>
+     *     message.metadata?.type === "plan"
+     *       ? <PlanCard key={message.id} data={message.metadata} />
+     *       : <Chat.DefaultMessage key={message.id} message={message} />
+     *   }
+     * </Chat.MessageList>
+     * ```
+     */
+    children?: (message: ChatMessage, index: number) => React$1.ReactNode;
+    className?: string;
+}
+/**
+ * Chat.MessageList — renders the message list using a render-prop pattern.
+ * Must be used inside <CopilotChat>.
+ *
+ * If no children are provided, renders all messages with the default SDK layout.
+ */
+declare function MessageList({ children, className }: MessageListProps): react_jsx_runtime.JSX.Element;
+
+type ChatHeaderProps = {
+    /** Logo image URL (pass empty string to hide logo) */
+    logo?: string;
+    /** Copilot name */
+    name?: string;
+    /** @deprecated Use `name` instead */
+    title?: string;
+    /** Thread picker element (injected by parent) */
+    threadPicker?: React__default.ReactNode;
+    /** Called when close button is clicked */
+    onClose?: () => void;
+    /** Additional class names */
+    className?: string;
+};
+declare function ChatHeader({ logo, name, title, threadPicker, onClose, className, }: ChatHeaderProps): react_jsx_runtime.JSX.Element;
+
 interface ChatWelcomeProps {
     /** Welcome screen configuration */
     config?: WelcomeConfig;
@@ -1928,6 +2042,73 @@ interface ChatWelcomeProps {
 }
 declare function ChatWelcome({ config, suggestions, recentThreads, onSendMessage, onSelectThread, onDeleteThread, onViewMoreThreads, isLoading, onStop, placeholder, attachmentsEnabled, attachmentsDisabledTooltip, maxFileSize, allowedFileTypes, processAttachment: processAttachmentProp, classNames, }: ChatWelcomeProps): react_jsx_runtime.JSX.Element;
 
+type DefaultMessageProps = {
+    message: ChatMessage;
+    userAvatar: {
+        src?: string;
+        fallback?: string;
+        component?: React$1.ReactNode;
+        className?: string;
+    };
+    assistantAvatar: {
+        src?: string;
+        fallback?: string;
+        component?: React$1.ReactNode;
+        className?: string;
+    };
+    showUserAvatar?: boolean;
+    userMessageClassName?: string;
+    assistantMessageClassName?: string;
+    /** Font size variant: 'sm' (14px), 'base' (16px), 'lg' (18px) */
+    size?: "sm" | "base" | "lg";
+    /** Whether this is the last message (for streaming state) */
+    isLastMessage?: boolean;
+    /** Whether the chat is currently loading/streaming */
+    isLoading?: boolean;
+    /** Whether waiting for server after tool completion */
+    isProcessing?: boolean;
+    /** Loader variant for typing indicator */
+    loaderVariant?: "dots" | "typing" | "wave" | "terminal" | "text-blink" | "text-shimmer" | "loading-dots";
+    /** Registered tools (for accessing tool's render function) */
+    registeredTools?: ToolDefinition[];
+    /** Custom renderers for tool results (Generative UI) - fallback when tool has no render prop */
+    toolRenderers?: ToolRenderers;
+    /** Catch-all renderer for MCP tools (tools with source: "mcp") */
+    mcpToolRenderer?: React$1.ComponentType<ToolRendererProps>;
+    /** Catch-all renderer for any tool not matched by toolRenderers */
+    fallbackToolRenderer?: React$1.ComponentType<ToolRendererProps>;
+    /** Called when user approves a tool execution */
+    onApproveToolExecution?: (executionId: string, extraData?: Record<string, unknown>, permissionLevel?: PermissionLevel) => void;
+    /** Called when user rejects a tool execution */
+    onRejectToolExecution?: (executionId: string, reason?: string, permissionLevel?: PermissionLevel) => void;
+    /** Show follow-up questions (default: true) */
+    showFollowUps?: boolean;
+    /** Called when a follow-up question is clicked */
+    onFollowUpClick?: (question: string) => void;
+    /** Custom class for follow-up container */
+    followUpClassName?: string;
+    /** Custom class for follow-up buttons */
+    followUpButtonClassName?: string;
+    /** Citation/Sources configuration */
+    citations?: CitationConfig;
+    /**
+     * Branch navigation info for this message.
+     * When non-null and totalSiblings > 1, the BranchNavigator is shown.
+     */
+    branchInfo?: BranchInfo | null;
+    /**
+     * Called when the user navigates to a sibling branch.
+     * Receives the message ID to switch to.
+     */
+    onSwitchBranch?: (messageId: string) => void;
+    /**
+     * Called when the user submits an edited message.
+     * Triggers a new branch from the same parent as messageId.
+     */
+    onEditMessage?: (messageId: string, newContent: string) => void;
+};
+declare function DefaultMessage({ message, userAvatar, assistantAvatar, showUserAvatar, userMessageClassName, assistantMessageClassName, size, isLastMessage, isLoading, isProcessing, loaderVariant, registeredTools, toolRenderers, mcpToolRenderer, fallbackToolRenderer, onApproveToolExecution, onRejectToolExecution, showFollowUps, onFollowUpClick, followUpClassName, followUpButtonClassName, citations, branchInfo, onSwitchBranch, onEditMessage, }: DefaultMessageProps): react_jsx_runtime.JSX.Element;
+
 interface ToolExecutionMessageProps {
     executions: ToolExecutionData[];
     assistantAvatar?: {
@@ -2234,4 +2415,52 @@ declare function MCPUIFrameList({ resources, onIntent, onError, className, frame
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { AlertTriangleIcon, type BackButtonProps, BotIcon, BranchNavigator, type BranchNavigatorProps, Button, CapabilityBadge, type CapabilityBadgeProps, CapabilityList, type CapabilityListProps, type CapabilityType, Chat, ChatContainerContent, ChatContainerRoot, ChatContainerScrollAnchor, type ChatMessage, 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, 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 };
+/**
+ * ChatPrimitives — composable primitives for building custom chat layouts.
+ * Must be used inside <CopilotChat>.
+ *
+ * @example
+ * ```tsx
+ * import { ChatPrimitives as Chat } from '@yourgpt/copilot-sdk-ui';
+ *
+ * <CopilotChat>
+ *   <Chat.Header />
+ *   <Chat.MessageList>
+ *     {(message) =>
+ *       message.metadata?.type === "plan"
+ *         ? <PlanCard key={message.id} />
+ *         : <Chat.DefaultMessage key={message.id} message={message} />
+ *     }
+ *   </Chat.MessageList>
+ *   <Chat.Input />
+ * </CopilotChat>
+ * ```
+ */
+declare const ChatPrimitives: {
+    /** Renders the message list via render-prop. Falls back to DefaultMessage if no children. */
+    MessageList: typeof MessageList;
+    /** Full SDK message bubble (user + assistant + tools). Use as fallback inside MessageList. */
+    DefaultMessage: typeof DefaultMessage;
+    /** Low-level message row wrapper (flex layout + avatar slot) */
+    Message: ({ children, className, ...props }: MessageProps) => react_jsx_runtime.JSX.Element;
+    /** Message avatar — image with fallback text/icon */
+    MessageAvatar: ({ src, alt, fallback, fallbackIcon, children, delayMs, className, }: MessageAvatarProps) => react_jsx_runtime.JSX.Element;
+    /** Message content bubble — supports markdown */
+    MessageContent: ({ children, markdown, className, size, ...props }: MessageContentProps) => react_jsx_runtime.JSX.Element;
+    /** Action bar below a message (copy, feedback, etc.) */
+    MessageActions: ({ children, className, ...props }: MessageActionsProps$1) => react_jsx_runtime.JSX.Element;
+    /** Single action button with tooltip inside MessageActions */
+    MessageAction: ({ tooltip, children, className, side, ...props }: MessageActionProps) => react_jsx_runtime.JSX.Element;
+    /** Chat header bar with title and controls */
+    Header: typeof ChatHeader;
+    /** Welcome screen shown when there are no messages */
+    Welcome: typeof ChatWelcome;
+    /** Chat input / composer */
+    Input: typeof PromptInput;
+    /** Scroll anchor — keeps the view pinned to the latest message */
+    ScrollAnchor: typeof ChatContainerScrollAnchor;
+    /** Loading / streaming indicator (dots, wave, typing variants) */
+    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 };