/**
 * OwlCoda Native WebSearch Tool
 *
 * Provides web search by fetching DuckDuckGo lite results.
 * This native implementation uses DuckDuckGo's HTML interface and does not
 * depend on a proprietary remote search API.
 */
import type { NativeToolDef } from './types.js';
export interface WebSearchInput {
    /** The search query */
    query: string;
    /** Maximum number of results to return (default: 8) */
    maxResults?: number;
}
export interface SearchResult {
    title: string;
    url: string;
    snippet: string;
}
/**
 * Parse DuckDuckGo lite HTML results into structured search results.
 * DDG lite returns a simple HTML table with results.
 */
export declare function parseDdgResults(html: string, maxResults: number): SearchResult[];
export declare function formatSearchResults(query: string, results: SearchResult[]): string;
export declare function createWebSearchTool(): NativeToolDef<WebSearchInput>;
