@defai.digital/ax-cli 3.2.0 → 3.4.0

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

@@ -0,0 +1,18 @@
+/**
+ * npm Registry Search Engine
+ * Free, unlimited search for npm packages
+ * No API key required
+ */
+import type { SearchEngine, WebSearchResult, SearchOptions } from "../types.js";
+export declare class NpmSearch implements SearchEngine {
+    readonly name = "npm";
+    private baseUrl;
+    private timeout;
+    /**
+     * Always available - no API key required
+     */
+    isAvailable(): boolean;
+    search(query: string, options?: SearchOptions): Promise<WebSearchResult[]>;
+    private formatResults;
+    private createSnippet;
+}

package/dist/tools/web-search/engines/npm.js

@@ -0,0 +1,86 @@
+/**
+ * npm Registry Search Engine
+ * Free, unlimited search for npm packages
+ * No API key required
+ */
+import axios from "axios";
+export class NpmSearch {
+    name = "npm";
+    baseUrl = "https://registry.npmjs.org/-/v1/search";
+    timeout = 10000; // 10 second timeout
+    /**
+     * Always available - no API key required
+     */
+    isAvailable() {
+        return true;
+    }
+    async search(query, options) {
+        try {
+            const params = new URLSearchParams({
+                text: query,
+                size: Math.min(options?.maxResults || 5, 20).toString(),
+            });
+            const response = await axios.get(`${this.baseUrl}?${params.toString()}`, {
+                timeout: options?.timeout || this.timeout,
+                headers: {
+                    Accept: "application/json",
+                },
+            });
+            return this.formatResults(response.data);
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                if (error.code === "ECONNABORTED") {
+                    throw new Error("npm search timeout");
+                }
+                throw new Error(`npm registry error: ${error.response?.data?.error || error.message}`);
+            }
+            throw error;
+        }
+    }
+    formatResults(response) {
+        return response.objects.map((pkg) => ({
+            title: pkg.package.name,
+            url: pkg.package.links.npm || `https://www.npmjs.com/package/${pkg.package.name}`,
+            snippet: this.createSnippet(pkg),
+            source: this.name,
+            relevanceScore: pkg.score.final * 100, // Convert 0-1 to 0-100
+            publishedDate: pkg.package.date,
+            metadata: {
+                version: pkg.package.version,
+                author: pkg.package.author?.name || pkg.package.publisher.username,
+                quality: pkg.score.detail.quality,
+                popularity: pkg.score.detail.popularity,
+                maintenance: pkg.score.detail.maintenance,
+                homepage: pkg.package.links.homepage,
+                repository: pkg.package.links.repository,
+            },
+        }));
+    }
+    createSnippet(pkg) {
+        const parts = [];
+        if (pkg.package.description) {
+            parts.push(pkg.package.description);
+        }
+        parts.push(`v${pkg.package.version}`);
+        if (pkg.package.author?.name) {
+            parts.push(`by ${pkg.package.author.name}`);
+        }
+        // Add quality indicators
+        const quality = pkg.score.detail.quality;
+        const popularity = pkg.score.detail.popularity;
+        const maintenance = pkg.score.detail.maintenance;
+        const indicators = [];
+        if (quality > 0.7)
+            indicators.push("high quality");
+        if (popularity > 0.7)
+            indicators.push("popular");
+        if (maintenance > 0.7)
+            indicators.push("well-maintained");
+        if (indicators.length > 0) {
+            parts.push(`(${indicators.join(", ")})`);
+        }
+        return parts.join(" • ");
+    }
+}
+//# sourceMappingURL=npm.js.map

package/dist/tools/web-search/engines/npm.js.map

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

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

@@ -0,0 +1,18 @@
+/**
+ * PyPI (Python Package Index) Search Engine
+ * Free, unlimited search for Python packages
+ * No API key required
+ */
+import type { SearchEngine, WebSearchResult, SearchOptions } from "../types.js";
+export declare class PyPISearch implements SearchEngine {
+    readonly name = "pypi";
+    private baseUrl;
+    private timeout;
+    /**
+     * Always available - no API key required
+     */
+    isAvailable(): boolean;
+    search(query: string, options?: SearchOptions): Promise<WebSearchResult[]>;
+    private formatResult;
+    private createSnippet;
+}

package/dist/tools/web-search/engines/pypi.js

@@ -0,0 +1,75 @@
+/**
+ * PyPI (Python Package Index) Search Engine
+ * Free, unlimited search for Python packages
+ * No API key required
+ */
+import axios from "axios";
+// Note: PyPI's search API is being rebuilt, so we use direct package lookup instead
+export class PyPISearch {
+    name = "pypi";
+    baseUrl = "https://pypi.org/pypi";
+    timeout = 10000; // 10 second timeout
+    /**
+     * Always available - no API key required
+     */
+    isAvailable() {
+        return true;
+    }
+    async search(query, options) {
+        try {
+            // PyPI's official search is being rebuilt, so we use direct package lookup
+            // Try to fetch package info directly
+            const packageResponse = await axios.get(`${this.baseUrl}/${encodeURIComponent(query)}/json`, {
+                timeout: options?.timeout || this.timeout,
+                validateStatus: (status) => status === 200 || status === 404,
+            });
+            if (packageResponse.status === 404) {
+                // Package not found, return empty results
+                return [];
+            }
+            return this.formatResult(packageResponse.data);
+        }
+        catch (error) {
+            // Return empty results on error rather than failing
+            // PyPI search is a best-effort feature
+            return [];
+        }
+    }
+    formatResult(data) {
+        if (!data.info)
+            return [];
+        const info = data.info;
+        return [
+            {
+                title: info.name,
+                url: `https://pypi.org/project/${info.name}/`,
+                snippet: this.createSnippet(info),
+                source: this.name,
+                relevanceScore: 100, // Exact match
+                publishedDate: info.release_date,
+                metadata: {
+                    version: info.version,
+                    author: info.author,
+                    license: info.license,
+                    homepage: info.home_page || info.project_urls?.Homepage,
+                    requiresPython: info.requires_python,
+                },
+            },
+        ];
+    }
+    createSnippet(info) {
+        const parts = [];
+        if (info.summary) {
+            parts.push(info.summary);
+        }
+        parts.push(`v${info.version}`);
+        if (info.author) {
+            parts.push(`by ${info.author}`);
+        }
+        if (info.license) {
+            parts.push(`License: ${info.license}`);
+        }
+        return parts.join(" • ");
+    }
+}
+//# sourceMappingURL=pypi.js.map

package/dist/tools/web-search/engines/pypi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pypi.js","sourceRoot":"","sources":["../../../../src/tools/web-search/engines/pypi.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAO1B,oFAAoF;AAEpF,MAAM,OAAO,UAAU;IACL,IAAI,GAAG,MAAM,CAAC;IACtB,OAAO,GAAG,uBAAuB,CAAC;IAClC,OAAO,GAAG,KAAK,CAAC,CAAC,oBAAoB;IAE7C;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,MAAM,CACV,KAAa,EACb,OAAuB;QAEvB,IAAI,CAAC;YACH,2EAA2E;YAC3E,qCAAqC;YACrC,MAAM,eAAe,GAAG,MAAM,KAAK,CAAC,GAAG,CACrC,GAAG,IAAI,CAAC,OAAO,IAAI,kBAAkB,CAAC,KAAK,CAAC,OAAO,EACnD;gBACE,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC,OAAO;gBACzC,cAAc,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG;aAC7D,CACF,CAAC;YAEF,IAAI,eAAe,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACnC,0CAA0C;gBAC1C,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,OAAO,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,oDAAoD;YACpD,uCAAuC;YACvC,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,IAAS;QAC5B,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAC;QAE1B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,OAAO;YACL;gBACE,KAAK,EAAE,IAAI,CAAC,IAAI;gBAChB,GAAG,EAAE,4BAA4B,IAAI,CAAC,IAAI,GAAG;gBAC7C,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;gBACjC,MAAM,EAAE,IAAI,CAAC,IAAI;gBACjB,cAAc,EAAE,GAAG,EAAE,cAAc;gBACnC,aAAa,EAAE,IAAI,CAAC,YAAY;gBAChC,QAAQ,EAAE;oBACR,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,QAAQ,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,YAAY,EAAE,QAAQ;oBACvD,cAAc,EAAE,IAAI,CAAC,eAAe;iBACrC;aACF;SACF,CAAC;IACJ,CAAC;IAEO,aAAa,CAAC,IAAS;QAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAE/B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAClC,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;CACF"}

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

@@ -0,0 +1,17 @@
+/**
+ * Tavily AI Search Engine
+ * AI-optimized search designed for LLMs
+ * https://tavily.com/
+ */
+import type { SearchEngine, WebSearchResult, SearchOptions } from "../types.js";
+export declare class TavilySearch implements SearchEngine {
+    readonly name = "tavily";
+    private apiKey;
+    private baseUrl;
+    private timeout;
+    constructor();
+    isAvailable(): boolean;
+    search(query: string, options?: SearchOptions): Promise<WebSearchResult[]>;
+    private formatResults;
+    getAnswer(results: WebSearchResult[]): string | undefined;
+}

package/dist/tools/web-search/engines/tavily.js

@@ -0,0 +1,73 @@
+/**
+ * Tavily AI Search Engine
+ * AI-optimized search designed for LLMs
+ * https://tavily.com/
+ */
+import axios from "axios";
+export class TavilySearch {
+    name = "tavily";
+    apiKey;
+    baseUrl = "https://api.tavily.com/search";
+    timeout = 10000; // 10 second timeout
+    constructor() {
+        this.apiKey = process.env.TAVILY_API_KEY;
+    }
+    isAvailable() {
+        return !!this.apiKey;
+    }
+    async search(query, options) {
+        if (!this.isAvailable()) {
+            throw new Error("Tavily API key not configured");
+        }
+        try {
+            const response = await axios.post(this.baseUrl, {
+                api_key: this.apiKey,
+                query: query,
+                search_depth: options?.searchDepth || "basic",
+                max_results: Math.min(options?.maxResults || 5, 10),
+                include_answer: options?.includeAnswer ?? true,
+                include_domains: options?.includeDomains || [],
+                exclude_domains: options?.excludeDomains || [],
+            }, {
+                timeout: options?.timeout || this.timeout,
+                headers: {
+                    "Content-Type": "application/json",
+                },
+            });
+            return this.formatResults(response.data);
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                if (error.code === "ECONNABORTED") {
+                    throw new Error("Tavily search timeout");
+                }
+                if (error.response?.status === 401) {
+                    throw new Error("Invalid Tavily API key");
+                }
+                if (error.response?.status === 429) {
+                    throw new Error("Tavily rate limit exceeded");
+                }
+                throw new Error(`Tavily API error: ${error.response?.data?.message || error.message}`);
+            }
+            throw error;
+        }
+    }
+    formatResults(response) {
+        return response.results.map((result) => ({
+            title: result.title,
+            url: result.url,
+            snippet: result.content,
+            source: this.name,
+            relevanceScore: result.score * 100, // Convert 0-1 to 0-100
+            publishedDate: result.published_date,
+            metadata: {
+                answer: response.answer,
+                responseTime: response.response_time,
+            },
+        }));
+    }
+    getAnswer(results) {
+        return results[0]?.metadata?.answer;
+    }
+}
+//# sourceMappingURL=tavily.js.map

package/dist/tools/web-search/engines/tavily.js.map

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

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