@defai.digital/ax-cli 3.2.0 → 3.4.0

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;
+}

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

@@ -0,0 +1,256 @@
+/**
+ * Web Search Tool
+ * Main tool for web search functionality in AX CLI
+ */
+import { WebSearchRouter } from "./router.js";
+import { SearchCache } from "./cache.js";
+export class WebSearchTool {
+    router;
+    cache;
+    DEFAULT_MAX_RESULTS = 5;
+    MAX_RESULTS_LIMIT = 10;
+    MAX_PARALLEL_ENGINES = 3; // Execute up to 3 engines in parallel
+    constructor() {
+        this.router = new WebSearchRouter();
+        this.cache = new SearchCache();
+    }
+    /**
+     * Search the web for information
+     */
+    async search(query, options) {
+        try {
+            // Validate query
+            if (!query || query.trim().length === 0) {
+                return {
+                    success: false,
+                    error: "Search query cannot be empty",
+                };
+            }
+            // Sanitize query
+            const sanitizedQuery = this.sanitizeQuery(query);
+            // Note: hasAvailableEngines() always returns true now because npm search
+            // is available by default (no API key required). Optional: Configure
+            // TAVILY_API_KEY or BRAVE_API_KEY for enhanced search capabilities.
+            // Check cache first
+            const cached = this.cache.get(sanitizedQuery);
+            if (cached && cached.length > 0) {
+                return {
+                    success: true,
+                    output: this.formatResults(cached, sanitizedQuery, true),
+                };
+            }
+            // Detect intent and select engines
+            const intent = this.router.detectIntent(sanitizedQuery);
+            const engines = this.router.selectEngines(intent);
+            if (engines.length === 0) {
+                return {
+                    success: false,
+                    error: "No search engine available",
+                };
+            }
+            // Prepare search options
+            const searchOptions = {
+                maxResults: Math.min(options?.maxResults || this.DEFAULT_MAX_RESULTS, this.MAX_RESULTS_LIMIT),
+                includeAnswer: options?.includeAnswer ?? true,
+                searchDepth: options?.searchDepth || "basic",
+                freshness: options?.freshness,
+                includeDomains: options?.includeDomains,
+                excludeDomains: options?.excludeDomains,
+            };
+            // Execute searches in parallel across multiple engines
+            const parallelCount = Math.min(engines.length, this.MAX_PARALLEL_ENGINES);
+            const enginesToUse = engines.slice(0, parallelCount);
+            // Execute all searches in parallel
+            const searchPromises = enginesToUse.map((engine) => engine
+                .search(sanitizedQuery, searchOptions)
+                .then((results) => ({ engine: engine.name, results, error: null }))
+                .catch((error) => ({
+                engine: engine.name,
+                results: [],
+                error: error.message,
+            })));
+            const searchResults = await Promise.all(searchPromises);
+            // Aggregate and deduplicate results
+            const results = this.aggregateResults(searchResults, searchOptions.maxResults || this.DEFAULT_MAX_RESULTS);
+            // Cache results (5 minute TTL)
+            if (results.length > 0) {
+                this.cache.set(sanitizedQuery, results, 300);
+            }
+            // Get list of engines that were used
+            const enginesUsed = searchResults
+                .filter((r) => r.results.length > 0)
+                .map((r) => r.engine);
+            // Format and return results
+            return {
+                success: true,
+                output: this.formatResults(results, sanitizedQuery, false, intent.type, enginesUsed),
+            };
+        }
+        catch (error) {
+            // Handle specific error cases
+            if (error.message?.includes("timeout")) {
+                return {
+                    success: false,
+                    error: "Search request timed out. Please try again.",
+                };
+            }
+            if (error.message?.includes("rate limit")) {
+                return {
+                    success: false,
+                    error: "Search rate limit exceeded. Please try again later.",
+                };
+            }
+            if (error.message?.includes("API key")) {
+                return {
+                    success: false,
+                    error: "Search API authentication failed. Please check your API keys.",
+                };
+            }
+            // Generic error
+            return {
+                success: false,
+                error: `Web search error: ${error.message}`,
+            };
+        }
+    }
+    /**
+     * Sanitize search query to prevent injection attacks
+     */
+    sanitizeQuery(query) {
+        return query
+            .replace(/[<>\"\']/g, "") // Remove special characters
+            .trim()
+            .slice(0, 500); // Max length
+    }
+    /**
+     * Aggregate and deduplicate results from multiple search engines
+     */
+    aggregateResults(searchResults, maxResults) {
+        const urlMap = new Map();
+        const scores = new Map();
+        // Aggregate results from all engines
+        for (const { engine, results } of searchResults) {
+            results.forEach((result, index) => {
+                const url = result.url;
+                // Calculate score based on position and source
+                // Earlier results and results from multiple engines get higher scores
+                const positionScore = maxResults - index;
+                const sourceBonus = this.getSourceBonus(engine);
+                const score = positionScore + sourceBonus;
+                if (!urlMap.has(url)) {
+                    // New result
+                    urlMap.set(url, result);
+                    scores.set(url, score);
+                }
+                else {
+                    // Duplicate - boost score (result appears in multiple engines)
+                    const existingScore = scores.get(url) || 0;
+                    scores.set(url, existingScore + score * 0.5); // 50% bonus for appearing in multiple sources
+                    // Merge metadata if the new result has additional info
+                    const existing = urlMap.get(url);
+                    if (result.metadata?.answer && !existing.metadata?.answer) {
+                        existing.metadata = {
+                            ...existing.metadata,
+                            answer: result.metadata.answer,
+                        };
+                    }
+                }
+            });
+        }
+        // Sort by score and return top results
+        const aggregated = Array.from(urlMap.entries())
+            .map(([url, result]) => ({
+            result,
+            score: scores.get(url) || 0,
+        }))
+            .sort((a, b) => b.score - a.score)
+            .slice(0, maxResults)
+            .map(({ result }) => result);
+        return aggregated;
+    }
+    /**
+     * Get bonus score for specific search engines
+     */
+    getSourceBonus(engine) {
+        // Prioritize certain engines based on reliability
+        switch (engine) {
+            case "tavily":
+                return 3; // Tavily has AI-powered relevance
+            case "npm":
+            case "pypi":
+            case "crates.io":
+                return 2; // Package registries are authoritative for packages
+            case "brave":
+                return 1; // General search engine
+            default:
+                return 0;
+        }
+    }
+    /**
+     * Format search results for display
+     */
+    formatResults(results, query, fromCache, intentType, enginesUsed) {
+        if (results.length === 0) {
+            return `No web search results found for "${query}".`;
+        }
+        let output = `Web search results for "${query}"`;
+        // Add cache indicator
+        if (fromCache) {
+            output += " (cached)";
+        }
+        // Add intent indicator if available
+        if (intentType && intentType !== "general") {
+            output += ` [${intentType}]`;
+        }
+        // Add engines used indicator (for parallel search)
+        if (enginesUsed && enginesUsed.length > 1) {
+            output += ` [sources: ${enginesUsed.join(", ")}]`;
+        }
+        output += ":\n\n";
+        // Extract AI-generated answer if available (from Tavily)
+        const answer = results[0]?.metadata?.answer;
+        if (answer && typeof answer === "string") {
+            output += `**Summary**: ${answer}\n\n`;
+        }
+        // Format each result
+        results.forEach((result, index) => {
+            output += `${index + 1}. **${result.title}**\n`;
+            output += `   URL: ${result.url}\n`;
+            output += `   ${result.snippet}\n`;
+            // Add published date if available
+            if (result.publishedDate) {
+                output += `   Published: ${result.publishedDate}\n`;
+            }
+            // Add source indicator
+            output += `   Source: ${result.source}\n`;
+            output += "\n";
+        });
+        // Add result count
+        if (results.length >= this.MAX_RESULTS_LIMIT) {
+            output += `Showing ${results.length} results (maximum). Refine your query for more specific results.\n`;
+        }
+        else {
+            output += `Found ${results.length} result${results.length === 1 ? "" : "s"}.\n`;
+        }
+        return output.trim();
+    }
+    /**
+     * Get cache statistics (for debugging/monitoring)
+     */
+    getCacheStats() {
+        return this.cache.getStats();
+    }
+    /**
+     * Clear search cache
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Check if web search is available
+     */
+    isAvailable() {
+        return this.router.hasAvailableEngines();
+    }
+}
+//# sourceMappingURL=web-search-tool.js.map

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

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

package/dist/types/analysis.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Analysis Types
+ *
+ * Type definitions for architecture analysis and best practice validation.
+ * All types are immutable and follow strict type safety principles.
+ */
+/**
+ * Analysis depth level
+ */
+export type AnalysisDepth = 'quick' | 'deep';
+/**
+ * Pattern detection confidence level (0.0 to 1.0)
+ */
+export type ConfidenceLevel = number;
+/**
+ * Severity levels for violations and anti-patterns
+ */
+export type Severity = 'critical' | 'high' | 'medium' | 'low' | 'info';
+/**
+ * Base analysis result containing common metadata
+ */
+export interface BaseAnalysisResult {
+    readonly timestamp: number;
+    readonly durationMs: number;
+    readonly projectPath: string;
+}
+/**
+ * Detected architectural or design pattern
+ */
+export interface DetectedPattern {
+    readonly name: string;
+    readonly category: 'architectural' | 'creational' | 'structural' | 'behavioral';
+    readonly confidence: ConfidenceLevel;
+    readonly locations: ReadonlyArray<string>;
+    readonly description: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Detected anti-pattern or code smell
+ */
+export interface AntiPattern {
+    readonly name: string;
+    readonly severity: Severity;
+    readonly locations: ReadonlyArray<string>;
+    readonly description: string;
+    readonly suggestion: string;
+    readonly impact: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Architecture improvement recommendation
+ */
+export interface ArchitectureRecommendation {
+    readonly title: string;
+    readonly priority: Severity;
+    readonly description: string;
+    readonly rationale: string;
+    readonly estimatedEffort: 'low' | 'medium' | 'high';
+    readonly benefits: ReadonlyArray<string>;
+    readonly tradeoffs: ReadonlyArray<string>;
+    readonly relatedPatterns: ReadonlyArray<string>;
+}
+/**
+ * Complete architecture analysis result
+ */
+export interface ArchitectureAnalysis extends BaseAnalysisResult {
+    readonly detectedPatterns: ReadonlyArray<DetectedPattern>;
+    readonly antiPatterns: ReadonlyArray<AntiPattern>;
+    readonly recommendations: ReadonlyArray<ArchitectureRecommendation>;
+    readonly architectureScore: number;
+    readonly summary: string;
+}
+/**
+ * Position in text (line and column)
+ */
+export interface Position {
+    readonly line: number;
+    readonly column: number;
+}
+/**
+ * Text range (start and end positions)
+ */
+export interface TextRange {
+    readonly start: Position;
+    readonly end: Position;
+}
+/**
+ * Text edit for automated fixes
+ */
+export interface TextEdit {
+    readonly range: TextRange;
+    readonly newText: string;
+}
+/**
+ * Automated fix for a validation violation
+ */
+export interface ViolationFix {
+    readonly description: string;
+    readonly edits: ReadonlyArray<TextEdit>;
+}
+/**
+ * Code validation violation
+ */
+export interface Violation {
+    readonly ruleId: string;
+    readonly severity: Severity;
+    readonly file: string;
+    readonly line: number;
+    readonly column: number;
+    readonly message: string;
+    readonly suggestion?: string;
+    readonly fix?: ViolationFix;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Single file validation result
+ */
+export interface ValidationResult extends BaseAnalysisResult {
+    readonly file: string;
+    readonly language: string;
+    readonly violations: ReadonlyArray<Violation>;
+    readonly score: number;
+    readonly summary: string;
+}
+/**
+ * Batch validation result for multiple files
+ */
+export interface BatchValidationResult extends BaseAnalysisResult {
+    readonly files: ReadonlyArray<ValidationResult>;
+    readonly totalViolations: number;
+    readonly criticalCount: number;
+    readonly highCount: number;
+    readonly averageScore: number;
+    readonly summary: string;
+}
+/**
+ * File information
+ */
+export interface FileInfo {
+    readonly path: string;
+    readonly relativePath: string;
+    readonly lines: number;
+    readonly size: number;
+    readonly extension: string;
+}
+/**
+ * Directory information
+ */
+export interface DirectoryInfo {
+    readonly path: string;
+    readonly relativePath: string;
+    readonly fileCount: number;
+    readonly subdirCount: number;
+}
+/**
+ * Project structure snapshot
+ */
+export interface ProjectStructure {
+    readonly rootPath: string;
+    readonly files: ReadonlyArray<FileInfo>;
+    readonly directories: ReadonlyArray<DirectoryInfo>;
+    readonly filesByExtension: ReadonlyMap<string, ReadonlyArray<FileInfo>>;
+    readonly totalLines: number;
+    readonly totalFiles: number;
+}
+/**
+ * Validation options
+ */
+export interface ValidationOptions {
+    readonly rules?: Readonly<Record<string, {
+        enabled: boolean;
+        severity?: Severity;
+        options?: Readonly<Record<string, unknown>>;
+    }>>;
+    readonly language?: 'typescript' | 'javascript';
+    readonly fix?: boolean;
+}

package/dist/types/analysis.js

@@ -0,0 +1,8 @@
+/**
+ * Analysis Types
+ *
+ * Type definitions for architecture analysis and best practice validation.
+ * All types are immutable and follow strict type safety principles.
+ */
+export {};
+//# sourceMappingURL=analysis.js.map

package/dist/types/analysis.js.map

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

package/dist/ui/components/api-key-input.js

@@ -72,9 +72,9 @@ export default function ApiKeyInput({ onApiKeySet }) {
         return formatMessage(uiMessages.save_location || "Note: API key will be saved to {path}", { path: settingsPath });
     }, [uiMessages.save_location]);
     return (React.createElement(Box, { flexDirection: "column", paddingX: 2, paddingY: 1 },
-        React.createElement(Text, { color: "yellow" }, uiMessages.title || "🔑 Grok API Key Required"),
+        React.createElement(Text, { color: "yellow" }, uiMessages.title || "🔑 API Key Required"),
         React.createElement(Box, { marginBottom: 1 },
-            React.createElement(Text, { color: "gray" }, uiMessages.prompt || "Please enter your Grok API key to continue:")),
+            React.createElement(Text, { color: "gray" }, uiMessages.prompt || "Please enter your API key to continue:")),
         React.createElement(Box, { borderStyle: "round", borderColor: "blue", paddingX: 1, marginBottom: 1 },
             React.createElement(Text, { color: "gray" }, "\u276F "),
             React.createElement(Text, null, displayText)),

package/dist/ui/components/api-key-input.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-key-input.js","sourceRoot":"","sources":["../../../src/ui/components/api-key-input.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"api-key-input.js","sourceRoot":"","sources":["../../../src/ui/components/api-key-input.tsx"],"names":[],"mappings":"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"}