import type { ToolDefinition } from "@mariozechner/pi-coding-agent";
export interface WebSearchToolOptions {
    enabled: boolean;
    provider: "brave" | "duck-duck-scrape";
    apiKey?: string;
    timeoutSeconds?: number;
    cacheTtlMinutes?: number;
    maxResults?: number;
    /** 单次搜索返回内容最大 token；超过则从尾部裁剪并打日志；不配置则不限制 */
    maxResultTokens?: number;
}
/**
 * 创建 web_search 工具。
 * - enabled 为 false 时返回 null，调用方不应将工具加入 customTools。
 * - enabled 为 true 但当前 provider 不可用（如 Brave 无 Key）时仍返回工具，执行时空转，返回固定提示。
 */
export declare function createWebSearchTool(options: WebSearchToolOptions): ToolDefinition | null;