import { ReactElement, ReactNode } from 'react';
export interface ConversationSource {
    /**
     * URL of the source, if applicable
     */
    url?: string;
    /**
     * Title or description of the source
     */
    title?: string;
    /**
     * Image URL of the source, if applicable.
     */
    image?: string;
}
export interface ConversationFile {
    /**
     * Name of the file
     */
    name: string;
    /**
     * Type of the file
     */
    type?: string;
    /**
     * Size of the file
     */
    size?: number;
    /**
     * URL of the file
     */
    url?: string;
}
export interface Template {
    /**
     * Unique identifier for the template
     */
    id: string;
    /**
     * Title of the template
     */
    title: string;
    /**
     * Message to be sent when template is selected
     */
    message: string;
    /**
     * Icon to display next to the template
     */
    icon?: ReactElement;
}
export interface Suggestion {
    /**
     * Unique identifier for the suggestion
     */
    id: string;
    /**
     * The display text for the suggestion
     */
    content: string;
}
export type MessageRole = 'user' | 'assistant' | 'system' | 'tool' | (string & {});
/**
 * Identity of the participant who sent a message. Lets multiple people
 * and multiple agents share one session — `role` describes *what kind*
 * of participant wrote the message, `author` describes *who*.
 */
export interface MessageAuthor {
    /**
     * Stable identifier for the participant, eg. a user or agent id
     */
    id?: string;
    /**
     * Display name rendered in the message header
     */
    name: string;
    /**
     * Avatar for the participant — an image URL or a custom node
     */
    avatar?: string | ReactNode;
}
export interface Message {
    /**
     * Unique identifier for the message
     */
    id: string;
    /**
     * What kind of participant authored the message
     */
    role: MessageRole;
    /**
     * Which participant authored the message. Optional — when present,
     * `SessionMessage` renders an author header (avatar + name) so
     * multiple people or agents can be told apart in one session.
     */
    author?: MessageAuthor;
    /**
     * Markdown content of the message
     */
    content: string;
    /**
     * Date and time when the message was created
     */
    createdAt?: Date;
    /**
     * Date and time when the message was last updated
     */
    updatedAt?: Date;
    /**
     * Sources referenced by this message (typically assistant messages)
     */
    sources?: ConversationSource[];
    /**
     * Files attached to this message (typically user messages)
     */
    files?: ConversationFile[];
    /**
     * Arbitrary structured data, e.g. tool call info:
     * `{ toolCallId, toolCallName, args }`
     */
    metadata?: Record<string, any>;
}
/**
 * @deprecated Use `Message` instead. Kept for backwards compatibility;
 * converted internally via `conversationsToMessages()`.
 */
export interface Conversation {
    /**
     * Unique identifier for the conversation
     */
    id: string;
    /**
     * Date and time when the conversation was created
     */
    createdAt: Date;
    /**
     * Date and time when the conversation was last updated
     */
    updatedAt?: Date;
    /**
     * The user's question or input that initiated the conversation
     */
    question: string;
    /**
     * The AI's response to the user's question
     */
    response?: string;
    /**
     * Array of sources referenced in the conversation
     */
    sources?: ConversationSource[];
    /**
     * Array of file paths or identifiers associated with the conversation
     */
    files?: ConversationFile[];
}
export interface Session {
    /**
     * Unique identifier for the session
     */
    id: string;
    /**
     * Title of the session
     */
    title?: string;
    /**
     * Date and time when the session was created
     */
    createdAt?: Date;
    /**
     * Date and time when the session was last updated
     */
    updatedAt?: Date;
    /**
     * Ordered list of messages in this session
     */
    messages?: Message[];
    /**
     * Array of conversations within this session
     *
     * @deprecated Use `messages`. Kept for backwards compatibility;
     * converted internally via `conversationsToMessages()`.
     */
    conversations?: Conversation[];
}