import type { AparteMessage, AparteSegment } from '../types.js';
import type { AparteChatImperativeApi } from '@aparte/core';
/**
 * Idiomatic React ergonomics for `<AparteChat>`. Owns the `messages` state and
 * the component ref so the consumer doesn't have to wire `onMessagesChange`
 * back into `messages` by hand. Spread `ref` + `messages` + `onMessagesChange`
 * onto `<AparteChat>` and drive it with the returned imperative helpers.
 *
 * @example
 * const chat = useAparteChat();
 * return (
 *   <AparteChat
 *     ref={chat.ref}
 *     messages={chat.messages}
 *     onMessagesChange={chat.setMessages}
 *   />
 * );
 * // The user's message is appended automatically on send — don't re-add it.
 */
export interface UseAparteChat {
    messages: AparteMessage[];
    setMessages: React.Dispatch<React.SetStateAction<AparteMessage[]>>;
    ref: React.RefObject<AparteChatImperativeApi>;
    appendMessage: (message: AparteMessage, options?: {
        historical?: boolean;
    }) => void;
    updateMessage: (messageId: string, updates: Partial<AparteMessage>) => void;
    updateLastMessage: (content: string, options?: {
        append?: boolean;
    }) => void;
    addSegment: (segment: AparteSegment) => void;
    updateSegment: (segmentId: string, updates: Partial<AparteSegment>) => void;
    removeSegment: (segmentId: string) => void;
    appendToSegment: (segmentId: string, content: string) => void;
    /**
     * The host's list — the authority, and mid-stream a frame ahead of the
     * `messages` state, which is synced once per paint rather than per token.
     */
    getMessages: () => AparteMessage[];
    clearMessages: (options?: {
        revokeAttachments?: boolean;
    }) => void;
    addBranch: (messageId: string) => number;
    addSiblingOf: (existingId: string, message: AparteMessage) => string | null;
    truncateFrom: (messageId: string) => void;
    truncateResponsesAfter: (userMessageId: string) => void;
    injectTokenStream: (messageId: string, tokens: AsyncIterable<string>) => Promise<void>;
    stopTokenStream: () => void;
    setConversationId: (id: string | null) => Promise<void>;
    isStreaming: () => boolean;
    scrollToBottom: () => void;
    focusInput: () => void;
    /** The `<aparte-chat-viewport>` element — same accessor on all four wrappers. */
    getViewport: () => HTMLElement | null;
}
export declare function useAparteChat(initial?: AparteMessage[]): UseAparteChat;
//# sourceMappingURL=useAparteChat.d.ts.map