export interface ChatThreadScope {
    type: string;
    id: string;
    label?: string;
    /** Composer context key used by ambient resource context adapters. */
    contextKey?: string;
}
export interface ChatThreadSummary {
    id: string;
    title: string;
    preview: string;
    messageCount: number;
    createdAt: number;
    updatedAt: number;
    scope: ChatThreadScope | null;
    pinnedAt?: number | null;
    archivedAt?: number | null;
}
export interface ChatThreadData {
    id: string;
    ownerEmail: string;
    title: string;
    preview: string;
    threadData: string;
    messageCount: number;
    createdAt: number;
    updatedAt: number;
    scope: ChatThreadScope | null;
    pinnedAt?: number | null;
    archivedAt?: number | null;
}
export interface ChatThreadSnapshot {
    threadData: string;
    title: string;
    preview: string;
    messageCount: number;
}
export interface ChatThreadShareState {
    enabled: boolean;
    createdAt: number | null;
    updatedAt: number | null;
    revokedAt: number | null;
}
export interface ChatThreadShareLink extends ChatThreadShareState {
    token?: string;
    url: string;
}
type ThreadTitleSource = "generated" | "extracted";
export interface UseChatThreadsOptions {
    /** Create an optimistic empty thread on mount when no active thread exists. */
    autoCreate?: boolean;
    /** Restore the active thread from localStorage. Defaults to true. */
    restoreActiveThread?: boolean;
    /**
     * Route-owned active thread. `undefined` preserves the legacy localStorage
     * source of truth; a string opens that thread; `null` means the URL is in
     * create/new-chat mode.
     */
    routeThreadId?: string | null;
}
export declare function useChatThreads(apiUrl?: string, storageKey?: string, scope?: ChatThreadScope | null, options?: UseChatThreadsOptions): {
    threads: ChatThreadSummary[];
    activeThreadId: string | null;
    isLoading: boolean;
    createThread: (preferredId?: string) => Promise<string | null>;
    switchThread: (id: string) => void;
    deleteThread: (id: string) => Promise<void>;
    detachThread: (threadId: string) => Promise<void>;
    pinThread: (threadId: string, pinned: boolean) => Promise<boolean>;
    archiveThread: (threadId: string) => Promise<boolean>;
    renameThread: (threadId: string, title: string) => Promise<boolean>;
    forkThread: (sourceId: string, sourceSnapshot?: ChatThreadSnapshot | null) => Promise<string | null>;
    saveThreadData: (id: string, data: {
        threadData: string;
        title: string;
        preview: string;
        messageCount?: number;
        titleSource?: ThreadTitleSource;
    }) => Promise<void>;
    generateTitle: (threadId: string, message: string) => Promise<string | null>;
    searchThreads: (query: string) => Promise<ChatThreadSummary[]>;
    loadMoreThreads: () => Promise<void>;
    getThreadShareState: (threadId: string) => Promise<ChatThreadShareState | null>;
    createThreadShareLink: (threadId: string) => Promise<ChatThreadShareLink | null>;
    revokeThreadShareLink: (threadId: string) => Promise<ChatThreadShareState | null>;
    refreshThreads: () => void;
    hasMoreThreads: boolean;
    isLoadingMoreThreads: boolean;
    threadsLoadError: string | null;
    isNewThread: (id: string) => boolean;
};
export {};
//# sourceMappingURL=use-chat-threads.d.ts.map