@defai.digital/ax-cli 3.3.0 → 3.4.0

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

@@ -0,0 +1,13 @@
+/**
+ * Web Search Module
+ * Exports all web search functionality
+ */
+export { WebSearchTool } from "./web-search-tool.js";
+export { WebSearchRouter } from "./router.js";
+export { SearchCache } from "./cache.js";
+export { TavilySearch } from "./engines/tavily.js";
+export { BraveSearch } from "./engines/brave.js";
+export { NpmSearch } from "./engines/npm.js";
+export { PyPISearch } from "./engines/pypi.js";
+export { CratesSearch } from "./engines/crates.js";
+export type { WebSearchResult, SearchOptions, SearchIntent, SearchEngine, SearchEngineResponse, } from "./types.js";

package/dist/tools/web-search/index.js

@@ -0,0 +1,13 @@
+/**
+ * Web Search Module
+ * Exports all web search functionality
+ */
+export { WebSearchTool } from "./web-search-tool.js";
+export { WebSearchRouter } from "./router.js";
+export { SearchCache } from "./cache.js";
+export { TavilySearch } from "./engines/tavily.js";
+export { BraveSearch } from "./engines/brave.js";
+export { NpmSearch } from "./engines/npm.js";
+export { PyPISearch } from "./engines/pypi.js";
+export { CratesSearch } from "./engines/crates.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/web-search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/web-search/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,36 @@
+/**
+ * Search Router
+ * Detects query intent and routes to appropriate search engines
+ */
+import type { SearchEngine, SearchIntent } from "./types.js";
+export declare class WebSearchRouter {
+    private tavilyEngine;
+    private braveEngine;
+    private npmEngine;
+    private pypiEngine;
+    private cratesEngine;
+    private readonly technicalKeywords;
+    private readonly codeKeywords;
+    private readonly packageKeywords;
+    private readonly pythonKeywords;
+    private readonly rustKeywords;
+    private readonly newsKeywords;
+    constructor();
+    /**
+     * Detect the intent of a search query
+     */
+    detectIntent(query: string): SearchIntent;
+    /**
+     * Select the best search engines for a given intent
+     */
+    selectEngines(intent: SearchIntent): SearchEngine[];
+    /**
+     * Get all available engines
+     */
+    getAvailableEngines(): SearchEngine[];
+    /**
+     * Check if any search engine is available
+     * Always returns true because package search engines require no API key
+     */
+    hasAvailableEngines(): boolean;
+}

package/dist/tools/web-search/router.js

@@ -0,0 +1,280 @@
+/**
+ * Search Router
+ * Detects query intent and routes to appropriate search engines
+ */
+import { TavilySearch } from "./engines/tavily.js";
+import { BraveSearch } from "./engines/brave.js";
+import { NpmSearch } from "./engines/npm.js";
+import { PyPISearch } from "./engines/pypi.js";
+import { CratesSearch } from "./engines/crates.js";
+export class WebSearchRouter {
+    tavilyEngine;
+    braveEngine;
+    npmEngine;
+    pypiEngine;
+    cratesEngine;
+    // Keywords for intent detection
+    technicalKeywords = [
+        "error",
+        "exception",
+        "bug",
+        "fix",
+        "debug",
+        "troubleshoot",
+        "code",
+        "function",
+        "method",
+        "class",
+        "api",
+        "library",
+        "framework",
+        "npm",
+        "package",
+        "install",
+        "configure",
+        "implementation",
+        "syntax",
+        "typescript",
+        "javascript",
+        "python",
+        "java",
+        "rust",
+        "go",
+    ];
+    codeKeywords = [
+        "code",
+        "example",
+        "implementation",
+        "snippet",
+        "sample",
+        "github",
+        "repository",
+        "source",
+        "function",
+        "class",
+        "how to",
+        "tutorial",
+    ];
+    packageKeywords = [
+        "package",
+        "npm",
+        "library",
+        "module",
+        "install",
+        "dependency",
+        "dependencies",
+        "node_modules",
+        "yarn",
+        "pnpm",
+    ];
+    pythonKeywords = [
+        "python",
+        "pip",
+        "pypi",
+        "django",
+        "flask",
+        "fastapi",
+        "pandas",
+        "numpy",
+        "pytest",
+        "virtualenv",
+        "conda",
+        "poetry",
+    ];
+    rustKeywords = [
+        "rust",
+        "cargo",
+        "crate",
+        "crates.io",
+        "rustc",
+        "tokio",
+        "serde",
+        "actix",
+        "wasm",
+    ];
+    newsKeywords = [
+        "news",
+        "latest",
+        "today",
+        "yesterday",
+        "recent",
+        "update",
+        "announcement",
+        "release",
+        "2025",
+        "2024",
+        "current",
+        "breaking",
+        "trending",
+    ];
+    constructor() {
+        this.tavilyEngine = new TavilySearch();
+        this.braveEngine = new BraveSearch();
+        this.npmEngine = new NpmSearch(); // Always available (no API key)
+        this.pypiEngine = new PyPISearch(); // Always available (no API key)
+        this.cratesEngine = new CratesSearch(); // Always available (no API key)
+    }
+    /**
+     * Detect the intent of a search query
+     */
+    detectIntent(query) {
+        const lowerQuery = query.toLowerCase();
+        const words = lowerQuery.split(/\s+/);
+        let technicalScore = 0;
+        let codeScore = 0;
+        let newsScore = 0;
+        let packageScore = 0;
+        let pythonScore = 0;
+        let rustScore = 0;
+        // Count keyword matches
+        for (const word of words) {
+            if (this.technicalKeywords.some((kw) => word.includes(kw))) {
+                technicalScore++;
+            }
+            if (this.codeKeywords.some((kw) => word.includes(kw))) {
+                codeScore++;
+            }
+            if (this.newsKeywords.some((kw) => word.includes(kw))) {
+                newsScore++;
+            }
+            if (this.packageKeywords.some((kw) => word.includes(kw))) {
+                packageScore++;
+            }
+            if (this.pythonKeywords.some((kw) => word.includes(kw))) {
+                pythonScore++;
+            }
+            if (this.rustKeywords.some((kw) => word.includes(kw))) {
+                rustScore++;
+            }
+        }
+        // Determine primary intent
+        let type = "general";
+        let confidence = 0.5; // Default confidence
+        let language = undefined;
+        // Detect language first
+        if (pythonScore > 0 && pythonScore >= rustScore) {
+            language = "python";
+        }
+        else if (rustScore > 0 && rustScore > pythonScore) {
+            language = "rust";
+        }
+        else if (packageScore > 0) {
+            language = "javascript"; // npm implies JavaScript
+        }
+        // Package search takes priority if npm keywords detected
+        if (packageScore > 0 || pythonScore > 0 || rustScore > 0) {
+            type = "technical"; // Packages are technical
+            confidence = Math.min((packageScore + pythonScore + rustScore) / words.length + 0.6, 1.0);
+        }
+        else if (newsScore > 0) {
+            type = "news";
+            confidence = Math.min(newsScore / words.length + 0.5, 1.0);
+        }
+        else if (codeScore > technicalScore) {
+            type = "code";
+            confidence = Math.min(codeScore / words.length + 0.5, 1.0);
+        }
+        else if (technicalScore > 0) {
+            type = "technical";
+            confidence = Math.min(technicalScore / words.length + 0.5, 1.0);
+        }
+        return {
+            type,
+            requiresTechnical: technicalScore > 0 || packageScore > 0 || pythonScore > 0 || rustScore > 0,
+            requiresCode: codeScore > 0,
+            requiresNews: newsScore > 0,
+            confidence,
+            language,
+        };
+    }
+    /**
+     * Select the best search engines for a given intent
+     */
+    selectEngines(intent) {
+        const engines = [];
+        // Check if query contains package keywords - prioritize language-specific search
+        const hasPackageIntent = intent.requiresTechnical && intent.confidence > 0.6;
+        // Select engines based on intent type
+        switch (intent.type) {
+            case "technical":
+            case "code":
+                // Route to language-specific package search
+                if (hasPackageIntent && intent.language) {
+                    if (intent.language === "python") {
+                        engines.push(this.pypiEngine); // Python packages
+                    }
+                    else if (intent.language === "rust") {
+                        engines.push(this.cratesEngine); // Rust crates
+                    }
+                    else if (intent.language === "javascript") {
+                        engines.push(this.npmEngine); // npm packages
+                    }
+                }
+                else if (hasPackageIntent) {
+                    // Default to npm if language not detected
+                    engines.push(this.npmEngine);
+                }
+                // Tavily is great for technical queries
+                if (this.tavilyEngine.isAvailable()) {
+                    engines.push(this.tavilyEngine);
+                }
+                // Brave as fallback
+                if (this.braveEngine.isAvailable() && engines.length === 0) {
+                    engines.push(this.braveEngine);
+                }
+                break;
+            case "news":
+                // Brave has better news coverage
+                if (this.braveEngine.isAvailable()) {
+                    engines.push(this.braveEngine);
+                }
+                // Tavily as fallback
+                if (this.tavilyEngine.isAvailable() && engines.length === 0) {
+                    engines.push(this.tavilyEngine);
+                }
+                break;
+            case "general":
+            default:
+                // Tavily is optimized for AI/general queries
+                if (this.tavilyEngine.isAvailable()) {
+                    engines.push(this.tavilyEngine);
+                }
+                // Brave as fallback
+                if (this.braveEngine.isAvailable() && engines.length === 0) {
+                    engines.push(this.braveEngine);
+                }
+                break;
+        }
+        // Package search as ultimate fallback (always available, no API key needed)
+        // Prefer npm as it's most commonly used
+        if (engines.length === 0) {
+            engines.push(this.npmEngine);
+        }
+        return engines;
+    }
+    /**
+     * Get all available engines
+     */
+    getAvailableEngines() {
+        const engines = [];
+        if (this.tavilyEngine.isAvailable()) {
+            engines.push(this.tavilyEngine);
+        }
+        if (this.braveEngine.isAvailable()) {
+            engines.push(this.braveEngine);
+        }
+        // Package search engines are always available (no API key required)
+        engines.push(this.npmEngine);
+        engines.push(this.pypiEngine);
+        engines.push(this.cratesEngine);
+        return engines;
+    }
+    /**
+     * Check if any search engine is available
+     * Always returns true because package search engines require no API key
+     */
+    hasAvailableEngines() {
+        return true; // npm, PyPI, and crates.io search are always available
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/tools/web-search/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/tools/web-search/router.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,45 @@
+/**
+ * Web Search Types
+ * Common interfaces and types for web search functionality
+ */
+export interface WebSearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+    source: string;
+    relevanceScore?: number;
+    publishedDate?: string;
+    metadata?: Record<string, any>;
+}
+export interface SearchOptions {
+    maxResults?: number;
+    includeAnswer?: boolean;
+    searchDepth?: "basic" | "advanced";
+    freshness?: "day" | "week" | "month" | "year";
+    includeDomains?: string[];
+    excludeDomains?: string[];
+    timeout?: number;
+}
+export interface SearchIntent {
+    type: "general" | "technical" | "news" | "code";
+    requiresTechnical: boolean;
+    requiresCode: boolean;
+    requiresNews: boolean;
+    confidence: number;
+    language?: "javascript" | "python" | "rust";
+}
+export interface SearchEngine {
+    name: string;
+    search(query: string, options?: SearchOptions): Promise<WebSearchResult[]>;
+    isAvailable(): boolean;
+    getQuota?(): {
+        remaining: number;
+        limit: number;
+    };
+}
+export interface SearchEngineResponse {
+    results: WebSearchResult[];
+    answer?: string;
+    totalResults?: number;
+    query: string;
+}

package/dist/tools/web-search/types.js

@@ -0,0 +1,6 @@
+/**
+ * Web Search Types
+ * Common interfaces and types for web search functionality
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/web-search/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/web-search/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

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

@@ -0,0 +1,51 @@
+/**
+ * Web Search Tool
+ * Main tool for web search functionality in AX CLI
+ */
+import type { ToolResult } from "../../types/index.js";
+import type { SearchOptions } from "./types.js";
+export declare class WebSearchTool {
+    private router;
+    private cache;
+    private readonly DEFAULT_MAX_RESULTS;
+    private readonly MAX_RESULTS_LIMIT;
+    private readonly MAX_PARALLEL_ENGINES;
+    constructor();
+    /**
+     * Search the web for information
+     */
+    search(query: string, options?: SearchOptions): Promise<ToolResult>;
+    /**
+     * Sanitize search query to prevent injection attacks
+     */
+    private sanitizeQuery;
+    /**
+     * Aggregate and deduplicate results from multiple search engines
+     */
+    private aggregateResults;
+    /**
+     * Get bonus score for specific search engines
+     */
+    private getSourceBonus;
+    /**
+     * Format search results for display
+     */
+    private formatResults;
+    /**
+     * Get cache statistics (for debugging/monitoring)
+     */
+    getCacheStats(): {
+        keys: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+    };
+    /**
+     * Clear search cache
+     */
+    clearCache(): void;
+    /**
+     * Check if web search is available
+     */
+    isAvailable(): boolean;
+}