/**
 * The paper tools: search_papers, get_paper, get_web_source, read_paper,
 * match_quote, add_local_paper, forget_paper and purge_cache.
 *
 * Each reply ends with the services the call asked, so the user can see what
 * left the machine. FOOTBALL_DOCS_PAPERS=off stops every request that would
 * leave it; the library, local files and Zotero on this computer still work.
 */
import { type PaperOptions, type ToolResponse } from "./core.js";
import { type Lookup, type WebSourceArgs } from "./web.js";
export declare const SEARCH_SOURCES: readonly ["openalex", "arxiv", "sportrxiv", "zotero"];
export type SearchSource = (typeof SEARCH_SOURCES)[number];
export type SearchPapersArgs = {
    query: string;
    sources?: SearchSource[];
    max_results?: number;
    year_from?: number;
    year_to?: number;
};
export declare function searchPapers(args: SearchPapersArgs, options?: PaperOptions): Promise<ToolResponse>;
export type GetPaperArgs = {
    id: string;
};
export declare function getPaper(args: GetPaperArgs, options?: PaperOptions): Promise<ToolResponse>;
export declare function getWebSource(args: WebSourceArgs, options?: PaperOptions & {
    lookup?: Lookup;
}): Promise<ToolResponse>;
export type ReadPaperArgs = {
    id: string;
    section?: number;
    query?: string;
};
export declare function readPaper(args: ReadPaperArgs, options?: PaperOptions & {
    lookup?: Lookup;
}): Promise<ToolResponse>;
export type MatchQuoteArgs = {
    source: string;
    quote: string;
};
export declare function matchQuote(args: MatchQuoteArgs, options?: PaperOptions & {
    lookup?: Lookup;
}): Promise<ToolResponse>;
export type AddLocalPaperArgs = {
    path: string;
    id?: string;
};
export declare function addLocalPaper(args: AddLocalPaperArgs, options?: PaperOptions): Promise<ToolResponse>;
export type ForgetPaperArgs = {
    id: string;
};
export declare function forgetPaper(args: ForgetPaperArgs, options?: PaperOptions): Promise<ToolResponse>;
export type PurgeCacheArgs = {
    confirm: boolean;
};
export declare function purgeCache(args: PurgeCacheArgs, options?: PaperOptions): Promise<ToolResponse>;