import { z } from "zod";
/**
 * Probe an AI answer engine with a query. The whole point of this tool —
 * the AEO citability check — is to ask the same engines users will ask
 * and see whether they cite the page being audited. No proxies, no
 * heuristics. The cited-URLs list comes back, and if `candidateUrl` is
 * provided we report whether it (by hostname) appears.
 *
 * Provider key resolution: explicit `apiKey` arg → engine-specific env
 * var. Cached for 24h on `engine + query` — same query against the same
 * engine reliably hits the same answer for the cache window.
 */
export declare const askAiEngineTool: {
    name: string;
    description: string;
    inputSchema: z.ZodType<{
        engine: "anthropic" | "perplexity" | "gemini";
        query: string;
        candidateUrl?: string | undefined;
        apiKey?: string | undefined;
        cacheDir?: string | undefined;
    }, unknown, z.core.$ZodTypeInternals<{
        engine: "anthropic" | "perplexity" | "gemini";
        query: string;
        candidateUrl?: string | undefined;
        apiKey?: string | undefined;
        cacheDir?: string | undefined;
    }, unknown>>;
    outputSchema: z.ZodType<{
        engine: "anthropic" | "perplexity" | "gemini";
        query: string;
        answer: string;
        citedUrls: string[];
        candidateCited: boolean | null;
        fromCache: boolean;
        apiCostUsd: number;
    }, unknown, z.core.$ZodTypeInternals<{
        engine: "anthropic" | "perplexity" | "gemini";
        query: string;
        answer: string;
        citedUrls: string[];
        candidateCited: boolean | null;
        fromCache: boolean;
        apiCostUsd: number;
    }, unknown>>;
    toAiTool(): import("ai").Tool<{
        engine: "anthropic" | "perplexity" | "gemini";
        query: string;
        candidateUrl?: string | undefined;
        apiKey?: string | undefined;
        cacheDir?: string | undefined;
    }, import("./types.js").ToolResult<{
        engine: "anthropic" | "perplexity" | "gemini";
        query: string;
        answer: string;
        citedUrls: string[];
        candidateCited: boolean | null;
        fromCache: boolean;
        apiCostUsd: number;
    }>>;
    run(input: {
        engine: "anthropic" | "perplexity" | "gemini";
        query: string;
        candidateUrl?: string | undefined;
        apiKey?: string | undefined;
        cacheDir?: string | undefined;
    }, ctx?: import("./types.js").ToolExecuteContext): Promise<import("./types.js").ToolResult<{
        engine: "anthropic" | "perplexity" | "gemini";
        query: string;
        answer: string;
        citedUrls: string[];
        candidateCited: boolean | null;
        fromCache: boolean;
        apiCostUsd: number;
    }>>;
};
//# sourceMappingURL=ask-ai-engine.d.ts.map