@phuetz/code-buddy 0.1.0 → 0.1.1

package/dist/tools/web-search.d.ts

@@ -1,69 +1,84 @@
 import { ToolResult } from '../types/index.js';
+export type SearchProvider = 'brave' | 'perplexity' | 'serper' | 'duckduckgo' | 'brave-mcp';
 export interface WebSearchOptions {
     maxResults?: number;
     safeSearch?: boolean;
+    /** 2-letter country code for region-specific results (e.g., 'DE', 'US'). */
+    country?: string;
+    /** ISO language code for search results (e.g., 'de', 'en', 'fr'). */
+    search_lang?: string;
+    /** ISO language code for UI elements. */
+    ui_lang?: string;
+    /**
+     * Filter results by discovery time (Brave only).
+     * Values: 'pd' (past 24h), 'pw' (past week), 'pm' (past month),
+     * 'py' (past year), or date range 'YYYY-MM-DDtoYYYY-MM-DD'.
+     */
+    freshness?: string;
+    /** Force a specific provider instead of auto-fallback. */
+    provider?: SearchProvider;
 }
 export interface SearchResult {
     title: string;
     url: string;
     snippet: string;
+    /** Hostname extracted from URL */
+    siteName?: string;
+    /** Age/published info (Brave only) */
+    published?: string;
 }
+export interface PerplexitySearchResult {
+    content: string;
+    citations: string[];
+    model: string;
+}
+declare function normalizeFreshness(value: string | undefined): string | undefined;
+declare function resolveSiteName(url: string | undefined): string | undefined;
+declare function resolvePerplexityBaseUrl(apiKey?: string): string;
 /**
- * Web Search Tool using Serper API (Google Search) with DuckDuckGo fallback
+ * Web Search Tool — OpenClaw-aligned provider chain
+ *
+ * Provider resolution (auto mode):
+ *   Brave MCP → Brave API → Perplexity → Serper → DuckDuckGo
  *
- * Set SERPER_API_KEY environment variable to enable Serper
+ * Supports country, search_lang, ui_lang, freshness (Brave), Perplexity AI search.
  */
 export declare class WebSearchTool {
     private cache;
+    private perplexityCache;
     private cacheTTL;
     private serperApiKey;
+    private braveApiKey;
+    private perplexityApiKey;
     constructor();
-    /**
-     * Search the web using Serper API (Google) or DuckDuckGo fallback
-     */
     search(query: string, options?: WebSearchOptions): Promise<ToolResult>;
     /**
-     * Search using Serper API (Google Search)
+     * Perplexity AI search — returns synthesized answer with citations
      */
+    searchPerplexity(query: string, options?: WebSearchOptions): Promise<ToolResult>;
+    private buildProviderChain;
+    private searchWithProvider;
+    private buildCacheKey;
+    private isBraveMCPAvailable;
+    private searchViaBraveMCP;
+    private searchBraveAPI;
+    private runPerplexitySearch;
     private searchSerper;
-    /**
-     * Fetch and summarize a web page
-     */
-    fetchPage(url: string, _prompt?: string): Promise<ToolResult>;
-    /**
-     * Search using DuckDuckGo HTML
-     */
     private searchDuckDuckGo;
-    /**
-     * Detect if query is weather-related
-     */
+    fetchPage(url: string, _prompt?: string): Promise<ToolResult>;
+    private formatPerplexityResult;
     private isWeatherQuery;
-    /**
-     * Get weather emoji based on condition
-     */
     private getWeatherEmoji;
-    /**
-     * Format weather results nicely
-     */
     private formatWeatherResults;
-    /**
-     * Format search results for display
-     */
     private formatResults;
-    /**
-     * Extract readable text from HTML
-     */
     private extractTextFromHtml;
-    /**
-     * Strip HTML tags from text
-     */
     private stripHtml;
-    /**
-     * Decode HTML entities
-     */
     private decodeHtmlEntities;
-    /**
-     * Clear the cache
-     */
     clearCache(): void;
 }
+export declare const __testing: {
+    readonly normalizeFreshness: typeof normalizeFreshness;
+    readonly resolveSiteName: typeof resolveSiteName;
+    readonly resolvePerplexityBaseUrl: typeof resolvePerplexityBaseUrl;
+};
+export {};