/** * AI Tools Module * Defines tools the AI agent can use to explore the codebase */ /** * Create tools for codebase exploration */ export declare function createExplorationTools(projectRoot: string): { /** * Search code using ripgrep patterns */ searchCode: import("ai").Tool<{ pattern: string; fileType?: string | undefined; glob?: string | undefined; literal?: boolean | undefined; context?: number | undefined; maxResults?: number | undefined; }, string>; /** * Read a file's contents */ readFile: import("ai").Tool<{ path: string; startLine?: number | undefined; endLine?: number | undefined; }, string>; /** * List directory contents */ listDirectory: import("ai").Tool<{ path: string; recursive?: boolean | undefined; maxDepth?: number | undefined; }, string>; /** * Get package.json info including entry points and scripts */ getPackageInfo: import("ai").Tool<{ field?: string | undefined; }, string>; }; /** * Ripgrep skill reference for the AI agent */ export declare const RIPGREP_SKILL = "\n## ripgrep Code Search Skill\n\n### Essential Patterns\n\n**Find definitions:**\n- Python functions: pattern=\"^def \\w+\\(\", fileType=\"py\"\n- JS/TS functions: pattern=\"^(export )?(function|const) \\w+\", fileType=\"ts\"\n- Classes: pattern=\"^class \\w+\", fileType=\"py\"\n\n**Find symbol usage (CRITICAL: use word boundaries):**\n- Exact word: pattern=\"\\bSymbolName\\b\"\n- Literal string: pattern=\"exact.string\", literal=true\n\n**Find imports:**\n- ES imports: pattern=\"^import.*from\", fileType=\"ts\"\n- CommonJS: pattern=\"require\\(\", fileType=\"js\"\n\n**File type options:**\n- py (Python)\n- js (JavaScript)\n- ts (TypeScript)\n- rust (Rust)\n- go (Go)\n\n**Performance tips:**\n1. Always use fileType when possible\n2. Use literal=true for exact strings\n3. Use \\b for word boundaries (prevents partial matches)\n4. Keep maxResults reasonable\n\n**Word boundaries are critical:**\n- WITHOUT: pattern=\"log\" matches \"logger\", \"blogger\", \"catalog\"\n- WITH: pattern=\"\\blog\\b\" matches only \"log\"\n";