@cadraos/sdk 0.1.2

package/dist/chat/index.d.cts

@@ -0,0 +1,974 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+
+/**
+ * ChatAdapter interface for customizable API integration
+ *
+ * Implement this interface to:
+ * - Connect to different backends
+ * - Use direct DB access (in ai-saas-v2)
+ * - Mock for testing
+ *
+ * @module @cadraos/sdk/chat
+ */
+/**
+ * Input for starting an agent execution
+ */
+interface StartExecutionInput {
+    /** UUID of the agent to execute */
+    agentId: string;
+    /** Optional session ID for continuing a conversation */
+    sessionId?: string;
+    /** User message content */
+    content: string;
+    /** UUIDs of attached files */
+    attachmentUuids?: string[];
+}
+/**
+ * Input for sending a message in an existing session
+ */
+interface SendMessageInput {
+    /** Session ID */
+    sessionId: string;
+    /** Message content */
+    content: string;
+    /** UUIDs of attached files */
+    attachmentUuids?: string[];
+}
+/**
+ * Input for getting an upload URL
+ */
+interface UploadUrlInput {
+    /** Session ID */
+    sessionId: string;
+    /** Filename */
+    filename: string;
+    /** MIME type */
+    mimeType: string;
+    /** File size in bytes */
+    size: number;
+}
+/**
+ * Result from starting an execution
+ */
+interface ExecutionResult {
+    /** UUID of the created execution */
+    executionId: string;
+    /** UUID of the session (new or existing) */
+    sessionId: string;
+}
+/**
+ * Result from getting an upload URL
+ */
+interface UploadUrlResult {
+    /** Pre-signed upload URL */
+    uploadUrl: string;
+    /** UUID for the attachment */
+    attachmentUuid: string;
+}
+/**
+ * Execution status and result
+ */
+interface Execution {
+    /** Execution UUID */
+    uuid: string;
+    /** Current status */
+    status: "pending" | "running" | "completed" | "failed" | "cancelled";
+    /** Final result (when completed) */
+    result?: string;
+    /** Error message (when failed) */
+    error?: string;
+}
+/**
+ * Artifact generated during execution
+ */
+interface Artifact {
+    /** Artifact UUID */
+    uuid: string;
+    /** Artifact type */
+    type: "image" | "document" | "code" | "audio";
+    /** Filename */
+    filename: string;
+    /** MIME type */
+    mimeType: string;
+    /** Download URL */
+    url: string;
+}
+/**
+ * Attachment metadata for history messages
+ */
+interface HistoryAttachment {
+    /** Attachment UUID */
+    uuid: string;
+    /** Original filename */
+    filename: string;
+    /** MIME type */
+    mimeType: string;
+    /** File size in bytes */
+    size: number;
+    /** Category classification */
+    category: "document" | "image" | "audio";
+    /** Preview URL (for images) */
+    previewUrl?: string;
+    /** Thumbnail URL */
+    thumbnailUrl?: string;
+}
+/**
+ * Tool call data for history messages
+ */
+interface HistoryToolCall {
+    /** Tool call ID */
+    id: string;
+    /** Tool name */
+    name: string;
+    /** Tool arguments */
+    args?: Record<string, unknown>;
+    /** Tool result */
+    result?: unknown;
+    /** Execution status */
+    status: "pending" | "running" | "completed" | "failed";
+    /** Execution duration in ms */
+    durationMs?: number;
+}
+/**
+ * A message in the session history
+ */
+interface HistoryMessage {
+    /** Message UUID */
+    uuid: string;
+    /** Message role */
+    role: "user" | "assistant";
+    /** Message content */
+    content: string;
+    /** Message timestamp */
+    timestamp: string;
+    /** File attachments (for user messages) */
+    attachments?: HistoryAttachment[];
+    /** Tool calls (for assistant messages) */
+    toolCalls?: HistoryToolCall[];
+}
+/**
+ * Session with chat history
+ */
+interface SessionHistory {
+    /** Session UUID */
+    sessionId: string;
+    /** Agent UUID */
+    agentId: string;
+    /** Messages in chronological order */
+    messages: HistoryMessage[];
+    /** When the session was created */
+    createdAt: string;
+    /** When the session was last updated */
+    updatedAt: string;
+}
+/**
+ * ChatAdapter interface for API integration
+ *
+ * This interface decouples the UI from the API implementation,
+ * allowing:
+ * - Built-in HTTP adapter for external API consumers
+ * - Custom adapter for ai-saas-v2 (direct tRPC/DB access)
+ * - Testing with mock adapters
+ *
+ * @example
+ * ```typescript
+ * // Using default HTTP adapter
+ * const adapter = createDefaultAdapter({
+ *   baseUrl: 'https://api.example.com/api/v1/external',
+ *   apiKey: 'your-api-key',
+ *   orgId: 123,
+ * });
+ *
+ * // Using custom tRPC adapter
+ * const adapter: ChatAdapter = {
+ *   startExecution: (input) => api.agents.execute.mutate(input),
+ *   // ... other methods
+ * };
+ * ```
+ */
+interface ChatAdapter {
+    /**
+     * Start a new agent execution
+     * @param input - Execution input
+     * @returns Execution and session IDs
+     */
+    startExecution(input: StartExecutionInput): Promise<ExecutionResult>;
+    /**
+     * Send a message in an existing session
+     * @param input - Message input
+     * @returns Execution and session IDs
+     */
+    sendMessage(input: SendMessageInput): Promise<ExecutionResult>;
+    /**
+     * Cancel a running execution
+     * @param uuid - Execution UUID
+     */
+    cancelExecution(uuid: string): Promise<void>;
+    /**
+     * Get execution status and result
+     * @param uuid - Execution UUID
+     * @returns Execution details
+     */
+    getExecution(uuid: string): Promise<Execution>;
+    /**
+     * Get a pre-signed URL for uploading a file
+     * @param input - Upload URL input
+     * @returns Upload URL and attachment UUID
+     */
+    getUploadUrl(input: UploadUrlInput): Promise<UploadUrlResult>;
+    /**
+     * Confirm that a file upload has completed
+     * @param uuid - Attachment UUID
+     */
+    confirmUpload(uuid: string): Promise<void>;
+    /**
+     * Get a download URL for an attachment
+     * @param uuid - Attachment UUID
+     * @returns Signed download URL
+     */
+    getDownloadUrl(uuid: string): Promise<string>;
+    /**
+     * Get artifacts generated in a session
+     * @param sessionId - Session UUID
+     * @returns List of artifacts
+     */
+    getSessionArtifacts?(sessionId: string): Promise<Artifact[]>;
+    /**
+     * Load chat history for an existing session
+     *
+     * This method is optional. If not implemented, session loading will not be available.
+     * The returned data is designed to be cacheable with React Query, SWR, or Next.js caching.
+     *
+     * @param sessionId - Session UUID
+     * @returns Session with message history
+     */
+    getSessionHistory?(sessionId: string): Promise<SessionHistory>;
+    /**
+     * Get the SSE stream URL for an execution
+     * @param executionId - Execution UUID
+     * @returns Full URL for SSE connection
+     */
+    getStreamUrl(executionId: string): string;
+}
+
+/**
+ * Type definitions for @cadraos/sdk/chat
+ *
+ * @module @cadraos/sdk/chat
+ */
+/**
+ * Represents a chat message in the conversation
+ */
+interface ChatMessage$1 {
+    /** Unique identifier for the message */
+    id: string;
+    /** Role of the message sender */
+    role: "user" | "assistant" | "system";
+    /** Text content of the message */
+    content: string;
+    /** When the message was created */
+    timestamp: Date;
+    /** Whether this message is still streaming */
+    isStreaming?: boolean;
+    /** Attached files */
+    attachments?: AttachmentData[];
+    /** Tool calls made during this message */
+    toolCalls?: ToolCall[];
+    /** Thinking blocks (for models that support extended thinking) */
+    thinkingBlocks?: ThinkingBlock[];
+}
+/**
+ * Attachment data for files sent with messages
+ */
+interface AttachmentData {
+    /** Unique identifier */
+    uuid: string;
+    /** Original filename */
+    filename: string;
+    /** MIME type */
+    mimeType: string;
+    /** File size in bytes */
+    size: number;
+    /** Category classification */
+    category: "document" | "image" | "audio";
+    /** Preview URL (for images) */
+    previewUrl?: string;
+    /** Thumbnail URL */
+    thumbnailUrl?: string;
+    /** Upload status */
+    status?: "uploading" | "processing" | "ready" | "failed";
+}
+/**
+ * Tool call information
+ */
+interface ToolCall {
+    /** Unique identifier for the tool call */
+    id: string;
+    /** Name of the tool */
+    name: string;
+    /** Arguments passed to the tool */
+    args?: Record<string, unknown>;
+    /** Result from the tool execution */
+    result?: unknown;
+    /** Error message if tool failed */
+    error?: string;
+    /** Current status */
+    status: "pending" | "running" | "completed" | "failed";
+    /** Execution duration in milliseconds */
+    durationMs?: number;
+}
+/**
+ * Thinking block for extended thinking models
+ */
+interface ThinkingBlock {
+    /** Unique identifier */
+    id: string;
+    /** Thinking content */
+    content: string;
+    /** When the thinking block was created */
+    timestamp: Date;
+}
+/**
+ * Chat error information
+ */
+interface ChatError {
+    /** Error code for programmatic handling */
+    code: string;
+    /** Human-readable error message */
+    message: string;
+    /** Additional error details */
+    details?: Record<string, unknown>;
+    /** Whether the error is retryable */
+    retryable?: boolean;
+}
+/**
+ * Data for agent clarification requests (ask_user tool)
+ */
+interface ClarificationData {
+    /** The question being asked */
+    question: string;
+    /** Optional reason for asking */
+    reason?: string;
+    /** Suggested response options */
+    suggestedOptions?: string[];
+}
+/**
+ * Todo item for agent task lists
+ */
+interface TodoItem {
+    /** Task description (imperative form) */
+    content: string;
+    /** Current status */
+    status: "pending" | "in_progress" | "completed";
+    /** Present continuous form for active display */
+    activeForm: string;
+}
+/**
+ * SSE stream event from agent execution
+ */
+interface ExecutionStreamEvent {
+    /** Event type */
+    type: string;
+    /** Unique event ID for deduplication */
+    id: string;
+    /** ISO timestamp */
+    timestamp: string;
+    /** Event data payload */
+    data: {
+        type?: string;
+        log?: {
+            stepIndex: number;
+            logType: string;
+            message: string;
+            metadata: Record<string, unknown>;
+            timestamp: string;
+            durationMs?: number;
+        };
+        executionId?: string;
+        toolName?: string;
+        args?: unknown;
+        iteration?: number;
+        tokenUsage?: {
+            prompt: number;
+            completion: number;
+            total: number;
+        };
+        cost?: number;
+        error?: string;
+        question?: string;
+        reason?: string;
+        suggestedOptions?: string[];
+        redisAvailable?: boolean;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Theme mode options
+ */
+type ThemeMode = "light" | "dark" | "system";
+/**
+ * Attachment file for upload
+ */
+interface AttachmentFile {
+    /** File UUID after upload */
+    uuid: string;
+    /** Original file object */
+    file: File;
+    /** Upload status */
+    status: "pending" | "uploading" | "ready" | "failed";
+    /** Preview URL for local display */
+    previewUrl?: string;
+    /** Progress percentage (0-100) */
+    progress?: number;
+}
+
+interface AgentChatProps {
+    /** The UUID of the agent to chat with */
+    agentId: string;
+    /**
+     * Session ID to resume an existing conversation
+     * When provided, the component will load the session's chat history
+     */
+    sessionId?: string;
+    /** Custom adapter (optional - uses context if not provided) */
+    adapter?: ChatAdapter;
+    /** Callback fired when a new message is added */
+    onMessage?: (message: ChatMessage$1) => void;
+    /** Callback fired when an error occurs */
+    onError?: (error: ChatError) => void;
+    /**
+     * Callback fired when a new session is created
+     * Called with the sessionId when starting a new chat (no existing sessionId)
+     * Useful for updating external state like session lists
+     */
+    onSessionCreated?: (sessionId: string) => void;
+    /** @deprecated Use onSessionCreated instead */
+    onSessionStart?: (sessionId: string) => void;
+    /** Callback fired when a tool is called */
+    onToolCall?: (toolName: string, args: unknown) => void;
+    /** Callback fired when clarification is needed */
+    onClarification?: (data: ClarificationData) => void;
+    /** Initial messages to populate the chat */
+    initialMessages?: ChatMessage$1[];
+    /** Placeholder text for the input */
+    placeholder?: string;
+    /** Welcome message shown when chat is empty */
+    welcomeMessage?: string;
+    /** Maximum height of the chat container */
+    maxHeight?: string | number;
+    /** Additional CSS class for the container */
+    className?: string;
+    /** Theme mode */
+    theme?: ThemeMode;
+    /** Enable file attachments (future feature) */
+    enableAttachments?: boolean;
+    /** Enable markdown rendering */
+    enableMarkdown?: boolean;
+    /** Show tool call visualization */
+    showToolCalls?: boolean;
+}
+/**
+ * Complete chat interface for interacting with AI agents
+ *
+ * @example
+ * ```tsx
+ * // With ChatConfigProvider (recommended for API key users)
+ * <ChatConfigProvider config={{ baseUrl: '...', apiKey: '...' }}>
+ *   <AgentChat
+ *     agentId="agent-uuid"
+ *     onMessage={(msg) => console.log('New message:', msg)}
+ *   />
+ * </ChatConfigProvider>
+ *
+ * // With custom adapter
+ * <AgentChat
+ *   agentId="agent-uuid"
+ *   adapter={myCustomAdapter}
+ * />
+ * ```
+ */
+declare function AgentChat({ agentId, sessionId, adapter, onMessage, onError, onSessionCreated, onSessionStart, onToolCall, onClarification, initialMessages, placeholder, welcomeMessage, maxHeight, className, theme, enableAttachments, enableMarkdown, showToolCalls, }: AgentChatProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Default HTTP adapter for ChatAdapter
+ *
+ * Uses the AI SaaS External API for all operations.
+ *
+ * @module @cadraos/sdk/chat
+ */
+
+/**
+ * Configuration for the default HTTP adapter
+ */
+interface DefaultAdapterConfig {
+    /**
+     * Base URL for the API
+     * @example "https://api.example.com/api/v1/external"
+     */
+    baseUrl: string;
+    /**
+     * API key for authentication
+     */
+    apiKey?: string;
+    /**
+     * Organization ID for multi-tenant access
+     */
+    orgId?: number;
+    /**
+     * Custom fetch function (for testing or custom HTTP clients)
+     */
+    fetch?: typeof fetch;
+}
+/**
+ * Create a default HTTP adapter for the Chat component
+ *
+ * @param config - Adapter configuration
+ * @returns ChatAdapter implementation
+ *
+ * @example
+ * ```typescript
+ * const adapter = createDefaultAdapter({
+ *   baseUrl: 'https://api.example.com/api/v1/external',
+ *   apiKey: 'your-api-key',
+ *   orgId: 123,
+ * });
+ * ```
+ */
+declare function createDefaultAdapter(config: DefaultAdapterConfig): ChatAdapter;
+
+interface ChatConfigContextValue {
+    /** The configured adapter instance */
+    adapter: ChatAdapter;
+}
+interface ChatConfigProviderProps {
+    /**
+     * Configuration for the default HTTP adapter
+     */
+    config: DefaultAdapterConfig;
+    /**
+     * Child components
+     */
+    children: React.ReactNode;
+}
+/**
+ * Provider component that configures the default adapter for all child AgentChat components
+ *
+ * @example
+ * ```tsx
+ * import { ChatConfigProvider, AgentChat } from '@cadraos/sdk/chat';
+ *
+ * function App() {
+ *   return (
+ *     <ChatConfigProvider config={{
+ *       baseUrl: 'https://api.example.com/api/v1/external',
+ *       apiKey: 'your-api-key',
+ *       orgId: 123,
+ *     }}>
+ *       <AgentChat agentId="agent-uuid" />
+ *     </ChatConfigProvider>
+ *   );
+ * }
+ * ```
+ */
+declare function ChatConfigProvider({ config, children }: ChatConfigProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access the chat configuration from context
+ *
+ * @returns The chat configuration context value
+ * @throws Error if used outside of ChatConfigProvider
+ */
+declare function useChatConfig(): ChatConfigContextValue;
+/**
+ * Hook to optionally access the chat configuration from context
+ *
+ * @returns The chat configuration context value, or null if not available
+ */
+declare function useChatConfigOptional(): ChatConfigContextValue | null;
+
+interface UseAgentChatOptions {
+    /** UUID of the agent to chat with */
+    agentId: string;
+    /**
+     * Session ID to resume an existing conversation
+     * If provided, the hook will attempt to load the session history on mount
+     */
+    sessionId?: string;
+    /** Custom adapter (optional - uses context if not provided) */
+    adapter?: ChatAdapter;
+    /** Initial messages to populate the chat */
+    initialMessages?: ChatMessage$1[];
+    /** Callback fired when a new message is added */
+    onMessage?: (message: ChatMessage$1) => void;
+    /** Callback fired when an error occurs */
+    onError?: (error: ChatError) => void;
+    /**
+     * Callback fired when a new session is created
+     * Called with the sessionId when starting a new chat (no existing sessionId)
+     * Useful for updating external state like session lists
+     */
+    onSessionCreated?: (sessionId: string) => void;
+    /** @deprecated Use onSessionCreated instead */
+    onSessionStart?: (sessionId: string) => void;
+    /** Callback fired when a tool is called */
+    onToolCall?: (toolName: string, args: unknown) => void;
+    /** Callback fired when clarification is needed */
+    onClarification?: (data: ClarificationData) => void;
+}
+interface UseAgentChatResult {
+    /** Current messages in the chat */
+    messages: ChatMessage$1[];
+    /** Whether a message is being sent */
+    isLoading: boolean;
+    /** Whether the assistant is currently streaming */
+    isStreaming: boolean;
+    /** Whether session history is being loaded */
+    isLoadingHistory: boolean;
+    /** Current error if any */
+    error: ChatError | null;
+    /** Current session ID */
+    sessionId: string | null;
+    /** Current clarification request if any */
+    clarification: ClarificationData | null;
+    /** Send a message to the agent */
+    sendMessage: (content: string) => Promise<void>;
+    /** Respond to a clarification request */
+    respondToClarification: (response: string) => Promise<void>;
+    /** Cancel the current execution */
+    cancel: () => Promise<void>;
+    /** Retry the last failed message */
+    retry: () => void;
+    /** Clear the current error */
+    clearError: () => void;
+    /** Clear all messages and start a new session */
+    clearMessages: () => void;
+    /**
+     * Load history for a specific session
+     * @param sessionId - Session ID to load
+     * @returns Promise that resolves when history is loaded
+     */
+    loadSession: (sessionId: string) => Promise<void>;
+}
+declare function useAgentChat(options: UseAgentChatOptions): UseAgentChatResult;
+
+interface UseExecutionStreamOptions {
+    /** Execution ID to stream events for */
+    executionId: string | undefined;
+    /** Function to get stream URL - allows adapter pattern */
+    getStreamUrl: (executionId: string) => string;
+    /** Whether streaming is enabled */
+    enabled?: boolean;
+    /** Callback for all events */
+    onEvent?: (event: ExecutionStreamEvent) => void;
+    /** Callback for log events */
+    onLog?: (log: NonNullable<ExecutionStreamEvent["data"]["log"]>) => void;
+    /** Callback when a tool is called */
+    onToolCall?: (toolName: string, args: unknown) => void;
+    /** Callback when a tool returns a result */
+    onToolResult?: (toolName: string, result: unknown, durationMs: number) => void;
+    /** Callback for progress updates */
+    onProgress?: (data: {
+        iteration?: number;
+        tokenUsage?: {
+            prompt: number;
+            completion: number;
+            total: number;
+        };
+        cost?: number;
+    }) => void;
+    /** Callback when execution completes */
+    onComplete?: () => void;
+    /** Callback when an error occurs */
+    onError?: (error: string) => void;
+    /** Callback when agent needs clarification */
+    onClarification?: (data: ClarificationData) => void;
+    /** Callback when connection status changes */
+    onConnectionChange?: (connected: boolean, usingFallback: boolean) => void;
+}
+interface UseExecutionStreamResult {
+    /** Whether SSE is currently connected */
+    isConnected: boolean;
+    /** Whether using polling fallback */
+    isUsingFallback: boolean;
+    /** Connection error message if any */
+    connectionError: string | null;
+    /** Disconnect from the stream */
+    disconnect: () => void;
+    /** Reconnect to the stream */
+    reconnect: () => void;
+}
+/**
+ * Hook for streaming agent execution events via SSE
+ *
+ * @example
+ * ```typescript
+ * const { isConnected, disconnect } = useExecutionStream({
+ *   executionId: currentExecutionId,
+ *   getStreamUrl: (id) => adapter.getStreamUrl(id),
+ *   onLog: (log) => console.log(log.message),
+ *   onComplete: () => console.log('Done!'),
+ * });
+ * ```
+ */
+declare function useExecutionStream(options: UseExecutionStreamOptions): UseExecutionStreamResult;
+
+interface ChatContainerProps {
+    /** Child components (MessageList, ChatInput, etc.) */
+    children: React.ReactNode;
+    /** Maximum height of the container */
+    maxHeight?: string | number;
+    /** Additional CSS classes */
+    className?: string;
+    /** Theme mode */
+    theme?: ThemeMode;
+}
+/**
+ * Container component for the chat interface
+ *
+ * @example
+ * ```tsx
+ * <ChatContainer maxHeight="600px" theme="dark">
+ *   <MessageList messages={messages} />
+ *   <ChatInput onSend={handleSend} />
+ * </ChatContainer>
+ * ```
+ */
+declare function ChatContainer({ children, maxHeight, className, theme, }: ChatContainerProps): react_jsx_runtime.JSX.Element;
+
+interface ChatInputProps {
+    /** Callback when user sends a message */
+    onSend: (content: string) => void | Promise<void>;
+    /** Callback when user requests to stop/cancel */
+    onStop?: () => void;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Whether the input is disabled */
+    disabled?: boolean;
+    /** Whether currently sending/streaming */
+    isLoading?: boolean;
+    /** Whether to enable attachments */
+    enableAttachments?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Input component for sending chat messages
+ *
+ * @example
+ * ```tsx
+ * <ChatInput
+ *   onSend={async (content) => {
+ *     await sendMessage(content);
+ *   }}
+ *   placeholder="Type a message..."
+ *   disabled={isStreaming}
+ * />
+ * ```
+ */
+declare function ChatInput({ onSend, onStop, placeholder, disabled, isLoading, enableAttachments, className, }: ChatInputProps): react_jsx_runtime.JSX.Element;
+
+interface MessageListProps {
+    /** Array of messages to display */
+    messages: ChatMessage$1[];
+    /** Welcome message shown when chat is empty */
+    welcomeMessage?: string;
+    /** Whether a new message is loading */
+    isLoading?: boolean;
+    /** Whether the assistant is currently streaming a response */
+    isStreaming?: boolean;
+    /** Whether session history is being loaded */
+    isLoadingHistory?: boolean;
+    /** Whether to enable markdown rendering */
+    enableMarkdown?: boolean;
+    /** Whether to show tool calls */
+    showToolCalls?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Renders a scrollable list of chat messages with auto-scroll
+ *
+ * @example
+ * ```tsx
+ * <MessageList
+ *   messages={messages}
+ *   welcomeMessage="Hello! How can I help you today?"
+ *   isLoading={isLoading}
+ *   isStreaming={isStreaming}
+ *   enableMarkdown
+ *   showToolCalls
+ * />
+ * ```
+ */
+declare function MessageList({ messages, welcomeMessage, isLoading, isStreaming, isLoadingHistory, enableMarkdown, showToolCalls, className, }: MessageListProps): react_jsx_runtime.JSX.Element;
+
+interface ChatMessageProps {
+    /** Message data */
+    message: ChatMessage$1;
+    /** Whether to enable markdown rendering */
+    enableMarkdown?: boolean;
+    /** Whether to show tool calls */
+    showToolCalls?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Renders a single chat message with appropriate styling
+ *
+ * @example
+ * ```tsx
+ * <ChatMessage
+ *   message={{
+ *     id: "1",
+ *     role: "assistant",
+ *     content: "Hello! How can I help?",
+ *     timestamp: new Date(),
+ *   }}
+ *   enableMarkdown
+ *   showToolCalls
+ * />
+ * ```
+ */
+declare function ChatMessage({ message, enableMarkdown, showToolCalls, className, }: ChatMessageProps): react_jsx_runtime.JSX.Element;
+
+interface MarkdownContentProps {
+    /** Markdown content to render */
+    content: string;
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Renders markdown content with chat-appropriate styling
+ *
+ * @example
+ * ```tsx
+ * <MarkdownContent content="# Hello\n\nThis is **bold** text." />
+ * ```
+ */
+declare function MarkdownContent({ content, className }: MarkdownContentProps): react_jsx_runtime.JSX.Element;
+
+interface ToolCallEntryProps {
+    /** Tool call data */
+    toolCall: ToolCall;
+    /** Additional CSS classes */
+    className?: string;
+    /** Whether to show the full JSON in expanded view */
+    showFullJson?: boolean;
+}
+/**
+ * Displays a single tool call with status and expandable details
+ *
+ * @example
+ * ```tsx
+ * <ToolCallEntry
+ *   toolCall={{
+ *     id: "1",
+ *     name: "search_google",
+ *     status: "completed",
+ *     args: { query: "weather today" },
+ *     result: { results: [...] },
+ *     durationMs: 1234,
+ *   }}
+ * />
+ * ```
+ */
+declare function ToolCallEntry({ toolCall, className, showFullJson, }: ToolCallEntryProps): react_jsx_runtime.JSX.Element;
+
+interface AskUserPromptProps {
+    /** The question to display to the user */
+    question: string;
+    /** Optional predefined choices */
+    options?: string[];
+    /** Callback when user submits their response */
+    onSubmit: (response: string) => void;
+    /** Whether a response is required */
+    required?: boolean;
+    /** Whether the prompt is disabled (e.g., already responded) */
+    disabled?: boolean;
+    /** Current status */
+    status?: "waiting" | "submitted" | "processing";
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Input prompt for agent clarification requests
+ *
+ * @example
+ * ```tsx
+ * <AskUserPrompt
+ *   question="What format would you like the report in?"
+ *   options={["PDF", "CSV", "Excel"]}
+ *   onSubmit={(response) => handleClarification(response)}
+ * />
+ * ```
+ */
+declare function AskUserPrompt({ question, options, onSubmit, required, disabled, status, className, }: AskUserPromptProps): react_jsx_runtime.JSX.Element;
+
+interface TodoListProps {
+    /** List of todo items */
+    todos: TodoItem[];
+    /** Whether the list is collapsible */
+    collapsible?: boolean;
+    /** Default collapsed state */
+    defaultCollapsed?: boolean;
+    /** Custom title */
+    title?: string;
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Displays a task list with progress tracking
+ *
+ * @example
+ * ```tsx
+ * <TodoList
+ *   todos={[
+ *     { content: "Research topic", status: "completed", activeForm: "Researching topic" },
+ *     { content: "Write outline", status: "in_progress", activeForm: "Writing outline" },
+ *     { content: "Draft document", status: "pending", activeForm: "Drafting document" },
+ *   ]}
+ * />
+ * ```
+ */
+declare function TodoList({ todos, collapsible, defaultCollapsed, title, className, }: TodoListProps): react_jsx_runtime.JSX.Element | null;
+
+interface IconProps {
+    /** Additional CSS classes */
+    className?: string;
+    /** Accessibility label */
+    "aria-label"?: string;
+}
+declare function SendIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function MessageCircleIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function PaperclipIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function XIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function CheckIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function CheckCircleIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function CopyIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function ChevronDownIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function ChevronRightIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function ChevronLeftIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function LoadingSpinner({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function AlertCircleIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function CircleIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function StopCircleIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function ImageIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function ImagesIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function FileIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function FileTextIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function CodeIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function ZoomInIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function ZoomOutIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function DownloadIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function ExternalLinkIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function Minimize2Icon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function Maximize2Icon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function BotIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function UserIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function SparklesIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function ListTodoIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function HelpCircleIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function DatabaseIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+declare function ClockIcon({ className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
+
+export { AgentChat, type AgentChatProps, AlertCircleIcon, type Artifact, AskUserPrompt, type AskUserPromptProps, type AttachmentData, type AttachmentFile, BotIcon, type ChatAdapter, ChatConfigProvider, type ChatConfigProviderProps, ChatContainer, type ChatContainerProps, type ChatError, ChatInput, type ChatInputProps, ChatMessage, type ChatMessageProps, type ChatMessage$1 as ChatMessageType, CheckCircleIcon, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, CircleIcon, type ClarificationData, ClockIcon, CodeIcon, CopyIcon, DatabaseIcon, type DefaultAdapterConfig, DownloadIcon, type Execution, type ExecutionResult, type ExecutionStreamEvent, ExternalLinkIcon, FileIcon, FileTextIcon, HelpCircleIcon, type HistoryMessage, type IconProps, ImageIcon, ImagesIcon, ListTodoIcon, LoadingSpinner, MarkdownContent, type MarkdownContentProps, Maximize2Icon, MessageCircleIcon, MessageList, type MessageListProps, Minimize2Icon, PaperclipIcon, SendIcon, type SendMessageInput, type SessionHistory, SparklesIcon, type StartExecutionInput, StopCircleIcon, type ThemeMode, type ThinkingBlock, type TodoItem, TodoList, type TodoListProps, type ToolCall, ToolCallEntry, type ToolCallEntryProps, type UploadUrlInput, type UploadUrlResult, type UseAgentChatOptions, type UseAgentChatResult, type UseExecutionStreamOptions, type UseExecutionStreamResult, UserIcon, XIcon, ZoomInIcon, ZoomOutIcon, createDefaultAdapter, useAgentChat, useChatConfig, useChatConfigOptional, useExecutionStream };