erosolar-cli 1.7.367 → 1.7.369

package/dist/tools/localExplore.d.ts

@@ -0,0 +1,225 @@
+/**
+ * Local Explore Engine - Claude Code-style codebase exploration.
+ *
+ * This module implements an exploration system that mimics how Claude Code's
+ * explore agent works. It can work fully offline OR use the active AI model
+ * for enhanced query understanding and result summarization.
+ *
+ * Features:
+ * 1. Codebase indexing - Build a searchable index of files, functions, classes, imports
+ * 2. Query processing - Parse natural language questions and map to search strategies
+ * 3. Smart search - Combine glob, grep, and structure analysis
+ * 4. Answer generation - Format results in a Claude Code-like way
+ * 5. Caching - Store the index for fast subsequent queries
+ * 6. AI Enhancement (optional) - Use the active model for better query understanding
+ */
+import type { ToolDefinition } from '../core/toolRuntime.js';
+/**
+ * Function signature for AI enhancement.
+ * When provided, the explore engine can use the active AI model
+ * to improve query understanding and result summarization.
+ */
+export type AIEnhancer = (prompt: string) => Promise<string>;
+/**
+ * Context for AI-enhanced exploration.
+ */
+export interface ExploreContext {
+    /** Optional AI enhancer function - when provided, uses active AI for better results */
+    aiEnhancer?: AIEnhancer;
+    /** Whether to use AI for query parsing (requires aiEnhancer) */
+    aiQueryParsing?: boolean;
+    /** Whether to use AI for result summarization (requires aiEnhancer) */
+    aiSummarization?: boolean;
+}
+/**
+ * Register the global AI enhancer function.
+ * Call this when an AI session becomes available.
+ */
+export declare function setGlobalAIEnhancer(enhancer: AIEnhancer | null): void;
+/**
+ * Get the current global AI enhancer.
+ */
+export declare function getGlobalAIEnhancer(): AIEnhancer | null;
+export interface CodebaseIndex {
+    version: number;
+    createdAt: string;
+    rootDir: string;
+    hash: string;
+    files: IndexedFile[];
+    symbols: SymbolIndex;
+    imports: ImportGraph;
+    patterns: DetectedPatterns;
+    quickLookup: QuickLookup;
+}
+export interface IndexedFile {
+    path: string;
+    language: string;
+    size: number;
+    lineCount: number;
+    lastModified: number;
+    symbols: FileSymbols;
+    imports: string[];
+    exports: string[];
+    purpose: string;
+    tags: string[];
+}
+export interface FileSymbols {
+    functions: SymbolInfo[];
+    classes: SymbolInfo[];
+    interfaces: SymbolInfo[];
+    types: SymbolInfo[];
+    constants: SymbolInfo[];
+    variables: SymbolInfo[];
+}
+export interface SymbolInfo {
+    name: string;
+    line: number;
+    kind: 'function' | 'class' | 'interface' | 'type' | 'const' | 'variable' | 'method' | 'property';
+    isExported: boolean;
+    signature?: string;
+    docComment?: string;
+}
+export interface SymbolIndex {
+    byName: Map<string, SymbolLocation[]>;
+    byKind: Map<string, SymbolLocation[]>;
+    byFile: Map<string, string[]>;
+}
+export interface SymbolLocation {
+    file: string;
+    line: number;
+    kind: string;
+    signature?: string;
+}
+export interface ImportGraph {
+    imports: Map<string, string[]>;
+    importedBy: Map<string, string[]>;
+}
+export interface DetectedPatterns {
+    architecture: string[];
+    designPatterns: string[];
+    namingConventions: string[];
+    testPatterns: string[];
+    componentPatterns: string[];
+}
+export interface QuickLookup {
+    entryPoints: string[];
+    configFiles: string[];
+    testFiles: string[];
+    componentFiles: string[];
+    typeFiles: string[];
+    utilityFiles: string[];
+    routeFiles: string[];
+    modelFiles: string[];
+}
+export interface ExploreQuery {
+    type: 'find_file' | 'find_symbol' | 'find_usage' | 'understand' | 'explain' | 'search' | 'architecture' | 'dependencies';
+    keywords: string[];
+    filters: QueryFilters;
+    originalQuery: string;
+}
+export interface QueryFilters {
+    filePattern?: string;
+    language?: string;
+    symbolKind?: string;
+    limit?: number;
+}
+export interface ExploreResult {
+    query: string;
+    queryType: string;
+    files: FileMatch[];
+    symbols: SymbolMatch[];
+    answer: string;
+    suggestions: string[];
+    timeTaken: number;
+}
+export interface FileMatch {
+    path: string;
+    relevance: number;
+    reason: string;
+    snippets?: string[];
+}
+export interface SymbolMatch {
+    name: string;
+    file: string;
+    line: number;
+    kind: string;
+    relevance: number;
+}
+export declare class LocalExploreEngine {
+    private workingDir;
+    private index;
+    private indexPath;
+    private context;
+    constructor(workingDir: string, context?: ExploreContext);
+    /**
+     * Set or update the AI enhancer context.
+     * Call this to enable AI-enhanced exploration with the active model.
+     */
+    setContext(context: ExploreContext): void;
+    /**
+     * Initialize or load the codebase index.
+     * Returns true if a fresh index was built.
+     */
+    initialize(forceRebuild?: boolean): Promise<{
+        rebuilt: boolean;
+        fileCount: number;
+    }>;
+    /**
+     * Process a natural language query and return exploration results.
+     * Automatically uses the active AI model for better results when available.
+     */
+    explore(query: string, options?: {
+        useAI?: boolean;
+    }): Promise<ExploreResult>;
+    /**
+     * Use AI to parse a natural language query into structured exploration.
+     */
+    private parseQueryWithAI;
+    /**
+     * Use AI to generate a natural language summary of exploration results.
+     */
+    private summarizeWithAI;
+    /**
+     * Get a quick overview of the codebase.
+     */
+    getOverview(): string;
+    private tryLoadCache;
+    private saveCache;
+    private countFiles;
+    private buildIndex;
+    private collectFiles;
+    private indexFile;
+    private extractSymbols;
+    private extractImports;
+    private extractExports;
+    private inferPurpose;
+    private generateTags;
+    private categorizeFile;
+    private detectPatterns;
+    private parseQuery;
+    private executeQuery;
+    private findFiles;
+    private findSymbols;
+    private findUsages;
+    private explainArchitecture;
+    private showDependencies;
+    private explainConcept;
+    private generalSearch;
+    private generateSuggestions;
+}
+export interface ExploreToolOptions {
+    /** Working directory for exploration */
+    workingDir: string;
+    /** Optional AI enhancer for improved query understanding */
+    aiEnhancer?: AIEnhancer;
+    /** Enable AI query parsing (default: true if aiEnhancer provided) */
+    aiQueryParsing?: boolean;
+    /** Enable AI result summarization (default: true if aiEnhancer provided) */
+    aiSummarization?: boolean;
+}
+export declare function createLocalExploreTool(workingDir: string, options?: Partial<ExploreToolOptions>): ToolDefinition;
+/**
+ * Create all local exploration tools (explore + index management).
+ */
+export declare function createLocalExploreTools(workingDir: string, options?: Partial<ExploreToolOptions>): ToolDefinition[];
+//# sourceMappingURL=localExplore.d.ts.map

package/dist/tools/localExplore.d.ts.map

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