import type { LlmExecutionTools } from '../../../execution/LlmExecutionTools';
import type { id } from '../../../types/typeAliases';
import type { ChatProps } from '../Chat/ChatProps';
import type { SendMessageToLlmChatFunction } from '../hooks/useSendMessageToLlmChat';
import type { ChatMessage } from '../types/ChatMessage';
import type { ChatParticipant } from '../types/ChatParticipant';
/**
 * Determines how the chat reset action should behave when user clicks "New chat".
 */
type LlmChatResetMode = 'reset-current' | 'delegate';
/**
 * Props for LlmChat component, derived from ChatProps but with LLM-specific modifications
 *
 * @public exported from `@promptbook/components`
 */
export type LlmChatProps = Omit<ChatProps, 'messages' | 'onMessage' | 'onChange'> & {
    /**
     * Optional thread (full chat history) to be passed to LLM execution tools.
     * If not provided, the internal messages state will be used.
     */
    readonly thread?: ReadonlyArray<ChatMessage>;
    /**
     * LLM execution tools for chatting with the model
     */
    readonly llmTools: LlmExecutionTools;
    /**
     * Optional key for persisting conversation in localStorage
     * When provided, the conversation will be saved and restored from localStorage
     */
    readonly persistenceKey?: string;
    /**
     * Optional initial messages to pre-populate the chat.
     * - They can include both USER and ASSISTANT messages.
     * - They are only used when there is no persisted conversation (persistence takes precedence).
     * - They are not automatically persisted until the user sends a new message.
     */
    readonly initialMessages?: ReadonlyArray<ChatMessage>;
    /**
     * Called when the chat state changes (messages, participants, etc.)
     */
    onChange?(messages: ReadonlyArray<ChatMessage>, participants: ReadonlyArray<ChatParticipant>): void;
    /**
     * Optional external sendMessage function produced by useSendMessageToLlmChat hook.
     * When provided, LlmChat will attach its internal handler to it (no React context needed).
     */
    readonly sendMessage?: SendMessageToLlmChatFunction;
    /**
     * Name of the USER as participant in the chat
     *
     * @default 'USER'
     */
    readonly userParticipantName?: id;
    /**
     * Name of the LLM as participant in the chat
     *
     * @default 'ASSISTANT'
     */
    readonly llmParticipantName?: id;
    /**
     * Optional message to be automatically sent as if the user typed it.
     * This is useful for seamless transitions from other pages.
     */
    readonly autoExecuteMessage?: string;
    /**
     * Optional mapping of technical tool names to human-readable titles.
     * e.g., { "web_search": "Searching the web..." }
     */
    readonly toolTitles?: Record<string, string>;
    /**
     * Custom variants for the placeholder thinking message shown while the agent buffers its response.
     *
     * @default Shared thinking message variants
     */
    readonly thinkingMessages?: ReadonlyArray<string>;
    /**
     * Extra prompt parameters to merge into every chat request.
     */
    readonly promptParameters?: Record<string, unknown>;
    /**
     * Human-friendly text shown when `LlmChat` fails to process a message.
     * Use metadata overrides in apps (like Agents Server) instead of copying this string.
     */
    readonly chatFailMessage?: string;
    /**
     * Controls reset behavior for the action-bar "New chat" button.
     *
     * - `'reset-current'`: clears current message state and persistence key (default behavior).
     * - `'delegate'`: skips internal clearing and only calls `onReset`, letting the host app
     *   switch/create another immutable chat session.
     *
     * @default 'reset-current'
     */
    readonly resetMode?: LlmChatResetMode;
    /**
     * Optional custom error handler that will be called when an error occurs during chat.
     * If not provided, errors will be displayed as messages in the chat.
     *
     * @param error - The error that occurred
     * @param retry - Function to retry the last failed message
     */
    onError?(error: unknown, retry: () => void, failedMessage: {
        content: string;
        attachments: ChatMessage['attachments'];
    }): void;
};
export {};