/**
 * Web Search Types
 *
 * Unified types for web search responses across supported providers.
 */
/** Supported web search providers */
export type SearchProviderId = "exa" | "brave" | "jina" | "kimi" | "zai" | "anthropic" | "perplexity" | "gemini" | "codex" | "tavily" | "parallel" | "kagi" | "synthetic" | "searxng";
export declare function isSearchProviderId(value: string): value is SearchProviderId;
export declare function isSearchProviderPreference(value: string): value is SearchProviderId | "auto";
/** Source returned by search (all providers) */
export interface SearchSource {
    title: string;
    url: string;
    snippet?: string;
    /** ISO date string or relative ("2d ago") */
    publishedDate?: string;
    /** Age in seconds for consistent formatting */
    ageSeconds?: number;
    author?: string;
}
/** Citation with text reference (anthropic, perplexity) */
export interface SearchCitation {
    url: string;
    title: string;
    citedText?: string;
}
/** Usage metrics */
export interface SearchUsage {
    inputTokens?: number;
    outputTokens?: number;
    /** Anthropic: number of web search requests made */
    searchRequests?: number;
    /** Perplexity: combined token count */
    totalTokens?: number;
}
/** Unified response across providers */
export interface SearchResponse {
    provider: SearchProviderId | "none";
    /** Synthesized answer text (anthropic, perplexity) */
    answer?: string;
    /** Search result sources */
    sources: SearchSource[];
    /** Text citations with context */
    citations?: SearchCitation[];
    /** Intermediate search queries (anthropic) */
    searchQueries?: string[];
    /** Follow-up question suggestions (provider-dependent) */
    relatedQuestions?: string[];
    /** Token usage metrics */
    usage?: SearchUsage;
    /** Model used */
    model?: string;
    /** Request ID for debugging */
    requestId?: string;
    /** Authentication mode used by the provider (e.g. oauth, api-key) */
    authMode?: string;
}
/** Provider-specific error with optional HTTP status */
export declare class SearchProviderError extends Error {
    readonly provider: SearchProviderId;
    readonly status?: number | undefined;
    constructor(provider: SearchProviderId, message: string, status?: number | undefined);
}
/** Anthropic API response types */
export interface AnthropicSearchResult {
    type: "web_search_result";
    title: string;
    url: string;
    encrypted_content: string;
    page_age: string | null;
}
export interface AnthropicCitation {
    type: "web_search_result_location";
    url: string;
    title: string;
    cited_text: string;
    encrypted_index: string;
}
export interface AnthropicContentBlock {
    type: string;
    /** Text content (for type="text") */
    text?: string;
    /** Citations in text block */
    citations?: AnthropicCitation[];
    /** Tool name (for type="server_tool_use") */
    name?: string;
    /** Tool input (for type="server_tool_use") */
    input?: {
        query: string;
    };
    /** Search results (for type="web_search_tool_result") */
    content?: AnthropicSearchResult[];
}
export interface AnthropicApiResponse {
    id: string;
    model: string;
    content: AnthropicContentBlock[];
    usage: {
        input_tokens: number;
        output_tokens: number;
        cache_read_input_tokens?: number;
        cache_creation_input_tokens?: number;
        server_tool_use?: {
            web_search_requests: number;
        };
    };
}
/** Perplexity API types */
export type PerplexityChatMessageRole = "system" | "user" | "assistant" | "tool";
export interface PerplexityUrl {
    url: string;
}
export interface PerplexityVideoUrl {
    url: string;
    frame_interval?: string | number;
}
export interface PerplexityContentTextChunk {
    type: "text";
    text: string;
}
export interface PerplexityContentImageChunk {
    type: "image_url";
    image_url: PerplexityUrl | string;
}
export interface PerplexityContentFileChunk {
    type: "file_url";
    file_url: PerplexityUrl | string;
    file_name?: string | null;
}
export interface PerplexityContentPdfChunk {
    type: "pdf_url";
    pdf_url: PerplexityUrl | string;
}
export interface PerplexityContentVideoChunk {
    type: "video_url";
    video_url: PerplexityVideoUrl | string;
}
export type PerplexityContentChunk = PerplexityContentTextChunk | PerplexityContentImageChunk | PerplexityContentFileChunk | PerplexityContentPdfChunk | PerplexityContentVideoChunk;
export interface PerplexitySearchStepDetails {
    search_results: PerplexitySearchResult[];
    search_keywords: string[];
}
export interface PerplexityFetchUrlContentStepDetails {
    contents: PerplexitySearchResult[];
}
export interface PerplexityExecutePythonStepDetails {
    code: string;
    result: string;
}
export interface PerplexityReasoningStepInput {
    thought: string;
    type?: string | null;
    web_search?: PerplexitySearchStepDetails | null;
    fetch_url_content?: PerplexityFetchUrlContentStepDetails | null;
    execute_python?: PerplexityExecutePythonStepDetails | null;
}
export interface PerplexityReasoningStepOutput {
    thought: string;
    type?: string | null;
    web_search?: PerplexitySearchStepDetails | null;
    fetch_url_content?: PerplexityFetchUrlContentStepDetails | null;
    execute_python?: PerplexityExecutePythonStepDetails | null;
}
export interface PerplexityToolCallFunction {
    name?: string | null;
    arguments?: string | null;
}
export interface PerplexityToolCall {
    id?: string | null;
    type?: "function" | null;
    function?: PerplexityToolCallFunction | null;
}
export interface PerplexityMessageInput {
    role: PerplexityChatMessageRole;
    content: string | PerplexityContentChunk[] | null;
    reasoning_steps?: PerplexityReasoningStepInput[] | null;
    tool_calls?: PerplexityToolCall[] | null;
    tool_call_id?: string | null;
}
export interface PerplexityMessageOutput {
    role: PerplexityChatMessageRole;
    content: string | PerplexityContentChunk[] | null;
    reasoning_steps?: PerplexityReasoningStepOutput[] | null;
    tool_calls?: PerplexityToolCall[] | null;
    tool_call_id?: string | null;
}
export type PerplexityMessage = PerplexityMessageInput;
export interface PerplexityResponseFormatText {
    type: "text";
}
export interface PerplexityJSONSchema {
    schema: Record<string, unknown>;
    name?: string | null;
    description?: string | null;
    strict?: boolean | null;
}
export interface PerplexityResponseFormatJSONSchema {
    type: "json_schema";
    json_schema: PerplexityJSONSchema;
}
export interface PerplexityRegexSchema {
    regex: string;
    name?: string | null;
    description?: string | null;
    strict?: boolean | null;
}
export interface PerplexityResponseFormatRegex {
    type: "regex";
    regex: PerplexityRegexSchema;
}
export type PerplexityResponseFormat = PerplexityResponseFormatText | PerplexityResponseFormatJSONSchema | PerplexityResponseFormatRegex;
export interface PerplexityParameterSpec {
    type: string;
    properties: Record<string, unknown>;
    required?: string[] | null;
    additional_properties?: boolean | null;
}
export interface PerplexityFunctionSpec {
    name: string;
    description: string;
    parameters: PerplexityParameterSpec;
    strict?: boolean | null;
}
export interface PerplexityToolSpec {
    type: "function";
    function: PerplexityFunctionSpec;
}
export interface PerplexityUserLocation {
    latitude?: number | null;
    longitude?: number | null;
    country?: string | null;
    city?: string | null;
    region?: string | null;
}
export interface PerplexitySearchOptions {
    search_context_size?: "low" | "medium" | "high";
    search_type?: "fast" | "pro" | "auto" | null;
    user_location?: PerplexityUserLocation | null;
    image_results_enhanced_relevance?: boolean;
}
export interface PerplexityRequest {
    max_tokens?: number | null;
    temperature?: number | null;
    n?: number | null;
    model: string;
    stream?: boolean | null;
    stop?: string | string[] | null;
    cum_logprobs?: boolean | null;
    logprobs?: boolean | null;
    top_logprobs?: number | null;
    best_of?: number | null;
    response_metadata?: Record<string, unknown> | null;
    response_format?: PerplexityResponseFormat | null;
    diverse_first_token?: boolean | null;
    _inputs?: number[] | null;
    _prompt_token_length?: number | null;
    messages: PerplexityMessageInput[];
    tools?: PerplexityToolSpec[] | null;
    tool_choice?: "none" | "auto" | "required" | null;
    parallel_tool_calls?: boolean | null;
    web_search_options?: PerplexitySearchOptions;
    search_mode?: "web" | "academic" | "sec" | null;
    return_images?: boolean | null;
    return_related_questions?: boolean | null;
    num_search_results?: number;
    num_images?: number;
    enable_search_classifier?: boolean | null;
    disable_search?: boolean | null;
    search_domain_filter?: string[] | null;
    search_language_filter?: string[] | null;
    search_tenant?: string | null;
    ranking_model?: string | null;
    latitude?: number | null;
    longitude?: number | null;
    country?: string | null;
    search_recency_filter?: "hour" | "day" | "week" | "month" | "year" | null;
    search_after_date_filter?: string | null;
    search_before_date_filter?: string | null;
    last_updated_before_filter?: string | null;
    last_updated_after_filter?: string | null;
    image_format_filter?: string[] | null;
    image_domain_filter?: string[] | null;
    safe_search?: boolean | null;
    file_workspace_id?: string | null;
    updated_before_timestamp?: number | null;
    updated_after_timestamp?: number | null;
    search_internal_properties?: Record<string, unknown> | null;
    use_threads?: boolean | null;
    thread_id?: string | null;
    stream_mode?: "full" | "concise";
    _debug_pro_search?: boolean;
    has_image_url?: boolean;
    reasoning_effort?: "minimal" | "low" | "medium" | "high" | null;
    language_preference?: string | null;
    user_original_query?: string | null;
    _force_new_agent?: boolean | null;
}
export interface PerplexitySearchResult {
    title: string;
    url: string;
    date?: string | null;
    last_updated?: string | null;
    snippet?: string;
    source?: "web" | "attachment";
}
export interface PerplexityCost {
    input_tokens_cost: number;
    output_tokens_cost: number;
    reasoning_tokens_cost?: number | null;
    request_cost?: number | null;
    citation_tokens_cost?: number | null;
    search_queries_cost?: number | null;
    total_cost: number;
}
export interface PerplexityUsageInfo {
    prompt_tokens: number;
    completion_tokens: number;
    total_tokens: number;
    search_context_size?: string | null;
    citation_tokens?: number | null;
    num_search_queries?: number | null;
    reasoning_tokens?: number | null;
    cost: PerplexityCost;
}
export type PerplexityCompletionResponseType = "message" | "info" | "end_of_stream";
export type PerplexityCompletionResponseStatus = "PENDING" | "COMPLETED";
export interface PerplexityChoice {
    index: number;
    finish_reason?: "stop" | "length" | null;
    message: PerplexityMessageOutput;
    delta: PerplexityMessageOutput;
}
export interface PerplexityResponse {
    id: string;
    model: string;
    created: number;
    usage?: PerplexityUsageInfo | null;
    object?: string;
    choices: PerplexityChoice[];
    citations?: string[] | null;
    search_results?: PerplexitySearchResult[] | null;
    type?: PerplexityCompletionResponseType | null;
    status?: PerplexityCompletionResponseStatus | null;
}