import { ToolPart } from '../components/tool-types';
import { AttachmentData } from '../components/attachment-types';
/** The five built-in action buttons (each carries its own curated icon + label). */
export type ChatMessageAction = 'copy' | 'like' | 'dislike' | 'regenerate' | 'edit';
/** A like/dislike feedback vote on an assistant message. */
export type FeedbackVote = 'like' | 'dislike';
/** A host-defined action button. `icon` is a curated registry name (see
 *  `src/ui/action-icons.ts`); unknown/absent icons render label-only. */
export interface CustomAction {
    /** Emitted as the `kai-message-action` detail `action` when clicked. */
    id: string;
    /** Visible/`aria-label` text. */
    label: string;
    /** A curated icon name from the action-icon registry. */
    icon?: string;
    /** Tooltip text shown on hover. Defaults to `label` when omitted. */
    tooltip?: string;
}
/** The speaker avatar for a message row. (Mirrors the `…Data` convention of
 *  `AttachmentData`; named to avoid clashing with the `MessageAvatar` component.) */
export interface AvatarData {
    /** Image URL. When present, renders an `<img>`. */
    src?: string;
    /** Initials/short text shown when there is no `src`. */
    fallback?: string;
    /** Alt text for the image. */
    alt?: string;
}
export interface ChatMessage {
    id: string;
    role: 'user' | 'assistant';
    content: string;
    reasoning?: {
        text: string;
        label?: string;
    };
    tools?: ToolPart[];
    attachments?: AttachmentData[];
    /** Action buttons under the message — built-in names and/or custom descriptors. */
    actions?: (ChatMessageAction | CustomAction)[];
    /** Optional speaker avatar shown to the left of the message column. */
    avatar?: AvatarData;
    /** Controlled feedback vote. When set, it wins over the facade's internal
     *  optimistic state (`m.feedback ?? feedbackMap[m.id]`), so a host that
     *  persists votes can re-hydrate them. */
    feedback?: FeedbackVote;
}