/**
 * SkillKit Native Web Intelligence Tools
 * ========================================
 * 5 SkillTool implementations wrapping the native web engine.
 * Zero paid API dependencies. No keys required for basic operation.
 *
 * Tools:
 *   1. web_search    — Multi-source web search (DuckDuckGo + Google + SearXNG)
 *   2. web_extract   — Content extraction from any URL
 *   3. web_crawl     — Deep website crawling with link following
 *   4. web_research  — Multi-step deep research with AI synthesis
 *   5. web_map       — Site URL structure discovery
 *
 * @module web-tools
 */
import { z } from 'zod';
import type { SkillTool } from './index.js';
/**
 * Native web search — no API key required.
 * Multi-engine: DuckDuckGo HTML → Google HTML → SearXNG (if configured).
 */
export declare class WebSearchTool implements SkillTool {
    name: string;
    description: string;
    schema: z.ZodObject<{
        query: z.ZodString;
        max_results: z.ZodOptional<z.ZodNumber>;
        region: z.ZodOptional<z.ZodString>;
        time_range: z.ZodOptional<z.ZodEnum<["d", "w", "m", "y"]>>;
        searxng_url: z.ZodOptional<z.ZodString>;
    }, "strip", z.ZodTypeAny, {
        query: string;
        max_results?: number | undefined;
        searxng_url?: string | undefined;
        region?: string | undefined;
        time_range?: "d" | "w" | "m" | "y" | undefined;
    }, {
        query: string;
        max_results?: number | undefined;
        searxng_url?: string | undefined;
        region?: string | undefined;
        time_range?: "d" | "w" | "m" | "y" | undefined;
    }>;
    execute(input: unknown): Promise<unknown>;
}
/**
 * Native content extractor.
 * Fetches URLs and extracts clean text using content-density algorithm.
 * Handles: articles, docs, blog posts, product pages.
 */
export declare class WebExtractTool implements SkillTool {
    name: string;
    description: string;
    schema: z.ZodObject<{
        urls: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
        include_links: z.ZodOptional<z.ZodBoolean>;
        include_images: z.ZodOptional<z.ZodBoolean>;
        include_raw_html: z.ZodOptional<z.ZodBoolean>;
    }, "strip", z.ZodTypeAny, {
        urls: string | string[];
        include_links?: boolean | undefined;
        include_images?: boolean | undefined;
        include_raw_html?: boolean | undefined;
    }, {
        urls: string | string[];
        include_links?: boolean | undefined;
        include_images?: boolean | undefined;
        include_raw_html?: boolean | undefined;
    }>;
    execute(input: unknown): Promise<unknown>;
}
/**
 * Native web crawler.
 * BFS link-following from a starting URL with domain scoping and depth control.
 */
export declare class WebCrawlTool implements SkillTool {
    name: string;
    description: string;
    schema: z.ZodObject<{
        url: z.ZodString;
        max_depth: z.ZodOptional<z.ZodNumber>;
        max_pages: z.ZodOptional<z.ZodNumber>;
        include_patterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
        exclude_patterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
        same_domain_only: z.ZodOptional<z.ZodBoolean>;
    }, "strip", z.ZodTypeAny, {
        url: string;
        max_depth?: number | undefined;
        max_pages?: number | undefined;
        include_patterns?: string[] | undefined;
        exclude_patterns?: string[] | undefined;
        same_domain_only?: boolean | undefined;
    }, {
        url: string;
        max_depth?: number | undefined;
        max_pages?: number | undefined;
        include_patterns?: string[] | undefined;
        exclude_patterns?: string[] | undefined;
        same_domain_only?: boolean | undefined;
    }>;
    execute(input: unknown): Promise<unknown>;
}
/**
 * Native deep research engine.
 * Multi-step: search → extract → identify gaps → refine → repeat.
 * Optionally synthesizes findings via AI model callback.
 */
export declare class WebResearchTool implements SkillTool {
    name: string;
    description: string;
    schema: z.ZodObject<{
        query: z.ZodString;
        depth: z.ZodOptional<z.ZodEnum<["basic", "advanced"]>>;
        max_rounds: z.ZodOptional<z.ZodNumber>;
        max_sources: z.ZodOptional<z.ZodNumber>;
        searxng_url: z.ZodOptional<z.ZodString>;
    }, "strip", z.ZodTypeAny, {
        query: string;
        depth?: "basic" | "advanced" | undefined;
        searxng_url?: string | undefined;
        max_rounds?: number | undefined;
        max_sources?: number | undefined;
    }, {
        query: string;
        depth?: "basic" | "advanced" | undefined;
        searxng_url?: string | undefined;
        max_rounds?: number | undefined;
        max_sources?: number | undefined;
    }>;
    private synthesizeCallback?;
    /** Optionally inject an AI synthesis function (from ModelRouter) */
    setSynthesizer(fn: (findings: string[], query: string) => Promise<string>): void;
    execute(input: unknown): Promise<unknown>;
}
/**
 * Native site mapper.
 * Discovers all URLs on a domain via sitemap.xml + link crawling.
 */
export declare class WebMapTool implements SkillTool {
    name: string;
    description: string;
    schema: z.ZodObject<{
        url: z.ZodString;
        max_urls: z.ZodOptional<z.ZodNumber>;
        max_depth: z.ZodOptional<z.ZodNumber>;
        include_subdomains: z.ZodOptional<z.ZodBoolean>;
    }, "strip", z.ZodTypeAny, {
        url: string;
        max_depth?: number | undefined;
        max_urls?: number | undefined;
        include_subdomains?: boolean | undefined;
    }, {
        url: string;
        max_depth?: number | undefined;
        max_urls?: number | undefined;
        include_subdomains?: boolean | undefined;
    }>;
    execute(input: unknown): Promise<unknown>;
}
/**
 * Create all 5 native web intelligence tools.
 * No API keys required — all engines work out of the box.
 *
 * @example
 * ```ts
 * const tools = createWebTools();
 * for (const tool of tools) {
 *   registry.register(tool);
 * }
 * ```
 */
export declare function createWebTools(): SkillTool[];
//# sourceMappingURL=web-tools.d.ts.map