deepseek-coder-cli 1.0.0

package/dist/tools/fileTools.js

@@ -0,0 +1,342 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { readFile, stat } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import { buildError } from '../core/errors.js';
+import { parallelMap } from '../utils/asyncUtils.js';
+import { recordFileRead } from './fileReadTracker.js';
+// Maximum file size to read (10MB) to prevent memory exhaustion
+const MAX_FILE_SIZE = 10 * 1024 * 1024;
+const DEFAULT_SEARCH_HEAD_LIMIT = 50;
+export function createFileTools(workingDir) {
+    return [
+        {
+            name: 'read_file',
+            description: 'Read the contents of a file at the specified path. Returns content with line numbers. CRITICAL: ALWAYS use this tool BEFORE using Edit tool to get exact text including whitespace. Copy text directly from this output to old_string parameter in Edit. For large files, use offset and limit to read specific portions.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: 'The file path (relative to working directory or absolute)',
+                        minLength: 1,
+                    },
+                    offset: {
+                        type: 'number',
+                        description: 'Line number to start reading from (1-based). Defaults to 1.',
+                    },
+                    limit: {
+                        type: 'number',
+                        description: 'Maximum number of lines to read. Defaults to entire file (max 2000 lines for large files).',
+                    },
+                },
+                required: ['path'],
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const result = await readFileWithLineNumbers(workingDir, args['path'], args['offset'], args['limit']);
+                return result.output;
+            },
+        },
+        {
+            name: 'read_files',
+            description: 'Read multiple files in parallel with line numbers. Use this to avoid sequential read bottlenecks when inspecting several files.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    paths: {
+                        type: 'array',
+                        minItems: 1,
+                        items: {
+                            type: 'string',
+                            minLength: 1,
+                        },
+                        description: 'List of file paths to read (relative or absolute)',
+                    },
+                    offset: {
+                        type: 'number',
+                        description: 'Optional starting line for all files (1-based).',
+                    },
+                    limit: {
+                        type: 'number',
+                        description: 'Optional max lines to read for each file.',
+                    },
+                    concurrency: {
+                        type: 'number',
+                        description: 'Maximum number of files to read concurrently (default: 5, max: 10).',
+                    },
+                },
+                required: ['paths'],
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const pathsArg = args['paths'];
+                if (!Array.isArray(pathsArg) || pathsArg.length === 0) {
+                    return 'Error: paths must be a non-empty array of file paths.';
+                }
+                const sanitizedPaths = pathsArg
+                    .filter((value) => typeof value === 'string')
+                    .map((value) => value.trim())
+                    .filter(Boolean);
+                if (sanitizedPaths.length === 0) {
+                    return 'Error: paths must contain at least one valid string path.';
+                }
+                const concurrencyArg = typeof args['concurrency'] === 'number' ? Math.floor(args['concurrency']) : 5;
+                const concurrency = Math.min(Math.max(concurrencyArg, 1), 10);
+                const offsetArg = args['offset'];
+                const limitArg = args['limit'];
+                const results = await parallelMap(sanitizedPaths, async (path) => readFileWithLineNumbers(workingDir, path, offsetArg, limitArg), concurrency);
+                const header = `Read ${results.length} file${results.length === 1 ? '' : 's'} in parallel (max ${concurrency} concurrent):`;
+                const body = results.map((result) => result.output).join('\n\n---\n\n');
+                return [header, body].join('\n\n');
+            },
+        },
+        {
+            name: 'list_files',
+            description: 'List files and directories at the specified path',
+            cacheable: true,
+            cacheTtlMs: 4000, // short TTL to avoid stale listings while cutting redundant calls
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: 'The directory path (defaults to current working directory)',
+                        minLength: 1,
+                    },
+                    recursive: {
+                        type: 'boolean',
+                        description: 'Whether to list files recursively',
+                    },
+                },
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const pathArg = args['path'];
+                const requestedPath = normalizePathContext(pathArg);
+                let resolvedPath;
+                try {
+                    const dirPath = pathArg !== undefined && pathArg !== null ? resolveFilePath(workingDir, pathArg) : workingDir;
+                    resolvedPath = dirPath;
+                    const recursive = args['recursive'] === true;
+                    if (!existsSync(dirPath)) {
+                        return `Error: Directory not found: ${dirPath}`;
+                    }
+                    const files = listFilesRecursive(dirPath, recursive ? 5 : 1, workingDir);
+                    return `Directory: ${dirPath}\n\n${files.join('\n')}`;
+                }
+                catch (error) {
+                    return buildError('listing files', error, { path: requestedPath, resolvedPath });
+                }
+            },
+        },
+        {
+            name: 'search_files',
+            description: 'Search for files matching a pattern (supports glob patterns)',
+            parameters: {
+                type: 'object',
+                properties: {
+                    pattern: {
+                        type: 'string',
+                        description: 'The search pattern (e.g., "*.ts", "src/**/*.js")',
+                        minLength: 1,
+                    },
+                    path: {
+                        type: 'string',
+                        description: 'The directory to search in (defaults to current working directory)',
+                        minLength: 1,
+                    },
+                    head_limit: {
+                        type: 'number',
+                        description: `Maximum number of files to return. Defaults to ${DEFAULT_SEARCH_HEAD_LIMIT}.`,
+                    },
+                },
+                required: ['pattern'],
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const pathArg = args['path'];
+                const requestedPath = normalizePathContext(pathArg);
+                const patternArg = args['pattern'];
+                const requestedPattern = typeof patternArg === 'string' ? patternArg : undefined;
+                let resolvedPath;
+                try {
+                    const pattern = typeof patternArg === 'string' && patternArg.trim() ? patternArg : null;
+                    if (!pattern) {
+                        return 'Error: pattern must be a non-empty string.';
+                    }
+                    const headLimitArg = args['head_limit'];
+                    const headLimit = typeof headLimitArg === 'number' && Number.isFinite(headLimitArg) && headLimitArg > 0
+                        ? Math.floor(headLimitArg)
+                        : DEFAULT_SEARCH_HEAD_LIMIT;
+                    const searchPath = pathArg !== undefined && pathArg !== null ? resolveFilePath(workingDir, pathArg) : workingDir;
+                    resolvedPath = searchPath;
+                    const results = searchFilesGlob(searchPath, pattern).sort();
+                    if (results.length === 0) {
+                        return `No files found matching pattern: ${pattern}`;
+                    }
+                    const limited = results.slice(0, headLimit);
+                    const truncated = results.length > headLimit;
+                    const headerParts = [
+                        `Found ${results.length} file${results.length === 1 ? '' : 's'} matching "${pattern}"`,
+                        truncated ? `showing first ${headLimit}` : null,
+                    ].filter(Boolean);
+                    let output = `${headerParts.join(' ')}:\n\n${limited.map((f) => relative(workingDir, f)).join('\n')}`;
+                    if (truncated) {
+                        output += `\n\n... [${results.length - headLimit} more files truncated. Use head_limit parameter to see more]`;
+                    }
+                    return output;
+                }
+                catch (error) {
+                    return buildError('searching files', error, {
+                        path: requestedPath,
+                        resolvedPath,
+                        pattern: requestedPattern,
+                    });
+                }
+            },
+        },
+    ];
+}
+function resolveFilePath(workingDir, path) {
+    const validated = validatePathArg(path);
+    return validated.startsWith('/') ? validated : join(workingDir, validated);
+}
+function validatePathArg(path) {
+    if (typeof path !== 'string' || !path.trim()) {
+        throw new Error('Path must be a non-empty string.');
+    }
+    return path.trim();
+}
+function normalizePathContext(path) {
+    if (path === undefined || path === null) {
+        return undefined;
+    }
+    try {
+        return String(path);
+    }
+    catch {
+        return '(unprintable)';
+    }
+}
+function listFilesRecursive(dir, maxDepth, baseDir, currentDepth = 0) {
+    if (currentDepth >= maxDepth) {
+        return [];
+    }
+    const ignoredDirs = new Set(['.git', 'node_modules', 'dist', '.next', 'build', 'coverage']);
+    const results = [];
+    try {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (ignoredDirs.has(entry.name)) {
+                continue;
+            }
+            const fullPath = join(dir, entry.name);
+            const indent = '  '.repeat(currentDepth);
+            if (entry.isDirectory()) {
+                results.push(`${indent}${entry.name}/`);
+                results.push(...listFilesRecursive(fullPath, maxDepth, baseDir, currentDepth + 1));
+            }
+            else {
+                const stats = statSync(fullPath);
+                const size = formatFileSize(stats.size);
+                results.push(`${indent}${entry.name} ${size}`);
+            }
+        }
+    }
+    catch (error) {
+        // Ignore filesystem errors; best-effort file listing only.
+    }
+    return results;
+}
+function searchFilesGlob(dir, pattern) {
+    const results = [];
+    const regex = globToRegex(pattern);
+    function search(currentDir) {
+        const ignoredDirs = new Set(['.git', 'node_modules', 'dist', '.next', 'build', 'coverage']);
+        try {
+            const entries = readdirSync(currentDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (ignoredDirs.has(entry.name)) {
+                    continue;
+                }
+                const fullPath = join(currentDir, entry.name);
+                if (entry.isDirectory()) {
+                    search(fullPath);
+                }
+                else if (regex.test(fullPath)) {
+                    results.push(fullPath);
+                }
+            }
+        }
+        catch (error) {
+            // Ignore directory read errors and continue scanning.
+        }
+    }
+    search(dir);
+    return results;
+}
+function globToRegex(pattern) {
+    const escaped = pattern
+        .replace(/\./g, '\\.')
+        .replace(/\*\*/g, '.*')
+        .replace(/\*/g, '[^/]*')
+        .replace(/\?/g, '.');
+    return new RegExp(escaped);
+}
+function formatFileSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+async function readFileWithLineNumbers(workingDir, pathArg, offsetArg, limitArg) {
+    const requestedPath = normalizePathContext(pathArg);
+    let resolvedPath;
+    try {
+        const filePath = resolveFilePath(workingDir, pathArg);
+        resolvedPath = filePath;
+        if (!existsSync(filePath)) {
+            return { filePath, output: `Error: File not found: ${filePath}` };
+        }
+        const fileStats = await stat(filePath);
+        if (fileStats.size > MAX_FILE_SIZE) {
+            return {
+                filePath,
+                output: `Error: File too large (${formatFileSize(fileStats.size)}). Maximum allowed: ${formatFileSize(MAX_FILE_SIZE)}. Use offset and limit parameters to read specific portions.`,
+            };
+        }
+        const content = await readFile(filePath, 'utf-8');
+        const lines = content.split('\n');
+        const totalLines = lines.length;
+        const { offset, startLine, endLine } = normalizeReadWindow(totalLines, offsetArg, limitArg);
+        const selectedLines = lines.slice(startLine, endLine);
+        const numberedLines = selectedLines.map((line, idx) => {
+            const lineNum = String(startLine + idx + 1).padStart(6);
+            return `${lineNum}\t${line}`;
+        });
+        const showingRange = startLine > 0 || endLine < totalLines;
+        const rangeInfo = showingRange
+            ? ` (lines ${offset}-${endLine} of ${totalLines})`
+            : ` (${totalLines} lines)`;
+        // Track this read for "Read Before Edit" enforcement
+        recordFileRead(filePath, content, showingRange ? { start: startLine + 1, end: endLine } : undefined);
+        return {
+            filePath,
+            output: `File: ${filePath}${rangeInfo}\n\n${numberedLines.join('\n')}`,
+        };
+    }
+    catch (error) {
+        return { filePath: resolvedPath, output: buildError('reading file', error, { path: requestedPath, resolvedPath }) };
+    }
+}
+function normalizeReadWindow(totalLines, offsetArg, limitArg) {
+    const offset = typeof offsetArg === 'number' ? Math.max(1, Math.floor(offsetArg)) : 1;
+    const defaultLimit = totalLines > 2000 ? 2000 : totalLines;
+    const limit = typeof limitArg === 'number' ? Math.max(1, Math.floor(limitArg)) : defaultLimit;
+    const startLine = offset - 1;
+    const endLine = Math.min(startLine + limit, totalLines);
+    return { offset, startLine, endLine };
+}
+//# sourceMappingURL=fileTools.js.map

package/dist/tools/fileTools.js.map

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

package/dist/tools/grepTools.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from '../core/toolRuntime.js';
+export declare function createGrepTools(workingDir: string): ToolDefinition[];
+//# sourceMappingURL=grepTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grepTools.d.ts","sourceRoot":"","sources":["../../src/tools/grepTools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAe7D,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE,CA6HpE"}

package/dist/tools/grepTools.js

@@ -0,0 +1,129 @@
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative, isAbsolute } from 'node:path';
+const IGNORED_DIRS = new Set([
+    '.git',
+    'node_modules',
+    'dist',
+    '.next',
+    'build',
+    'coverage',
+    '.turbo',
+    '.cache',
+]);
+const MAX_FILE_SIZE = 2 * 1024 * 1024; // 2MB guard rail to avoid OOM
+export function createGrepTools(workingDir) {
+    return [
+        {
+            name: 'Grep',
+            description: 'Search file contents for a pattern with optional flags (case-insensitive, line numbers).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    pattern: { type: 'string', description: 'Regex or plain text pattern to search for.' },
+                    path: { type: 'string', description: 'Directory or file to search (defaults to working directory).' },
+                    output_mode: {
+                        type: 'string',
+                        enum: ['content', 'files_with_matches', 'count'],
+                        description: 'How to return results: full content, file list, or match count.',
+                    },
+                    ignore_case: { type: 'boolean', description: 'Case-insensitive search (alias: i).' },
+                    i: { type: 'boolean', description: 'Alias for ignore_case.' },
+                    line_numbers: { type: 'boolean', description: 'Include line numbers (alias: n).' },
+                    n: { type: 'boolean', description: 'Alias for line_numbers.' },
+                },
+                required: ['pattern'],
+                additionalProperties: true,
+            },
+            handler: async (args) => {
+                const pattern = typeof args['pattern'] === 'string' ? args['pattern'] : '';
+                if (!pattern.trim()) {
+                    return 'Error: pattern is required';
+                }
+                const outputMode = args['output_mode'] || 'content';
+                const ignoreCase = args['ignore_case'] === true || args['i'] === true;
+                const includeLineNumbers = args['line_numbers'] === true || args['n'] === true;
+                const searchRootInput = typeof args['path'] === 'string' && args['path'].trim()
+                    ? args['path'].trim()
+                    : workingDir;
+                const searchRoot = isAbsolute(searchRootInput)
+                    ? searchRootInput
+                    : join(workingDir, searchRootInput);
+                const regex = new RegExp(pattern, ignoreCase ? 'i' : undefined);
+                const matches = [];
+                const filesWithMatches = new Set();
+                function walk(dir) {
+                    let entries;
+                    try {
+                        entries = readdirSync(dir, { withFileTypes: true });
+                    }
+                    catch {
+                        return;
+                    }
+                    for (const entry of entries) {
+                        if (IGNORED_DIRS.has(entry.name))
+                            continue;
+                        const fullPath = join(dir, entry.name);
+                        if (entry.isDirectory()) {
+                            walk(fullPath);
+                            continue;
+                        }
+                        let stats;
+                        try {
+                            stats = statSync(fullPath);
+                        }
+                        catch {
+                            continue;
+                        }
+                        if (!stats.isFile() || stats.size > MAX_FILE_SIZE) {
+                            continue;
+                        }
+                        let content;
+                        try {
+                            content = readFileSync(fullPath, 'utf-8');
+                        }
+                        catch {
+                            continue;
+                        }
+                        const lines = content.split(/\r?\n/);
+                        for (let index = 0; index < lines.length; index++) {
+                            const line = lines[index] ?? '';
+                            if (!regex.test(line)) {
+                                continue;
+                            }
+                            const relativePath = relative(workingDir, fullPath);
+                            filesWithMatches.add(relativePath);
+                            if (outputMode === 'files_with_matches') {
+                                // Only need the filename once
+                                break;
+                            }
+                            const lineNumber = includeLineNumbers ? `${index + 1}:` : '';
+                            matches.push(`${relativePath}:${lineNumber}${line}`);
+                        }
+                    }
+                }
+                walk(searchRoot);
+                const MAX_DISPLAY_LINES = 5;
+                if (outputMode === 'files_with_matches') {
+                    if (!filesWithMatches.size) {
+                        return 'No matches found';
+                    }
+                    const files = Array.from(filesWithMatches).sort();
+                    if (files.length <= MAX_DISPLAY_LINES) {
+                        return files.join('\n');
+                    }
+                    return `${files.slice(0, MAX_DISPLAY_LINES).join('\n')}\n... +${files.length - MAX_DISPLAY_LINES} more files`;
+                }
+                if (outputMode === 'count') {
+                    return `Matches: ${matches.length}`;
+                }
+                if (!matches.length)
+                    return 'No matches found';
+                if (matches.length <= MAX_DISPLAY_LINES) {
+                    return matches.join('\n');
+                }
+                return `${matches.slice(0, MAX_DISPLAY_LINES).join('\n')}\n... +${matches.length - MAX_DISPLAY_LINES} more matches`;
+            },
+        },
+    ];
+}
+//# sourceMappingURL=grepTools.js.map

package/dist/tools/grepTools.js.map

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

package/dist/tools/humanOpsTools.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from '../core/toolRuntime.js';
+export declare function createHumanOpsTools(): ToolDefinition[];
+//# sourceMappingURL=humanOpsTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"humanOpsTools.d.ts","sourceRoot":"","sources":["../../src/tools/humanOpsTools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAgH7D,wBAAgB,mBAAmB,IAAI,cAAc,EAAE,CAgBtD"}

package/dist/tools/humanOpsTools.js

@@ -0,0 +1,86 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+function getTaskDir() {
+    const root = process.env['AGI_HUMAN_TASK_DIR'] || join(homedir(), '.agi', 'human-tasks');
+    mkdirSync(root, { recursive: true });
+    return root;
+}
+function safeTitle(title) {
+    return title.trim().replace(/[^\w\d-]+/g, '-').replace(/^-+|-+$/g, '').toLowerCase() || 'task';
+}
+function writeTask(record, path) {
+    mkdirSync(getTaskDir(), { recursive: true });
+    writeFileSync(path, JSON.stringify(record, null, 2), 'utf8');
+}
+function createNewTask(args) {
+    const dir = getTaskDir();
+    const title = args.title?.trim() || 'Untitled task';
+    const record = {
+        title,
+        context: args.context,
+        urgency: args.urgency ?? 'normal',
+        needsBrowser: args.needsBrowser ?? false,
+        needsCaptcha: args.needsCaptcha ?? false,
+        emailDomain: args.emailDomain,
+        catchAll: args.catchAll,
+        domainRegistrar: args.domainRegistrar,
+        paymentMethod: args.paymentMethod,
+        phoneVerification: args.phoneVerification,
+        ssoProviders: args.ssoProviders ?? [],
+        proxyPolicy: args.proxyPolicy,
+        steps: (args.steps && args.steps.length ? args.steps : ['Provide update and next actions']).map((s) => String(s)),
+        artifacts: args.artifacts,
+        updates: [
+            {
+                note: args.context ? `Initial context: ${args.context}` : 'Task created',
+                at: new Date().toISOString(),
+            },
+        ],
+    };
+    const path = join(dir, `${safeTitle(title)}-${Date.now()}.json`);
+    writeTask(record, path);
+    const lines = [
+        'Human task recorded',
+        `Title: ${title}`,
+        `Urgency: ${record.urgency}`,
+        record.needsBrowser ? 'Requires browser use' : 'No browser required',
+        record.needsCaptcha ? 'Requires captcha' : 'No captcha required',
+        record.emailDomain ? `Email domain: ${record.emailDomain}` : 'Email domain: n/a',
+        `Steps: ${record.steps.length}`,
+        `Saved at: ${path}`,
+    ];
+    return { path, record, message: lines.join('\n') };
+}
+function appendUpdate(taskPath, note) {
+    const content = readFileSync(taskPath, 'utf8');
+    const record = JSON.parse(content);
+    record.updates = record.updates ?? [];
+    record.updates.push({ note, at: new Date().toISOString() });
+    writeTask(record, taskPath);
+    const lines = [
+        'Update appended to human task',
+        `Title: ${record.title}`,
+        `Updates: ${record.updates.length}`,
+        `Saved at: ${taskPath}`,
+    ];
+    return { path: taskPath, record, message: lines.join('\n') };
+}
+export function createHumanOpsTools() {
+    return [
+        {
+            name: 'HumanIntegration',
+            description: 'Create or update human-in-the-loop tasks with rich metadata (browser, captcha, domain/email needs).',
+            handler: async (args) => {
+                if (args.taskPath && existsSync(args.taskPath)) {
+                    const updateNote = args.update?.trim() || 'Update added';
+                    const { message } = appendUpdate(args.taskPath, updateNote);
+                    return message;
+                }
+                const { message } = createNewTask(args);
+                return message;
+            },
+        },
+    ];
+}
+//# sourceMappingURL=humanOpsTools.js.map

package/dist/tools/humanOpsTools.js.map

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

package/dist/tools/localExplore.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Local Explore - Minimal stub for backward compatibility
+ */
+export type AIEnhancer = (prompt: string) => Promise<string>;
+export declare function setGlobalAIEnhancer(enhancer: AIEnhancer | null): void;
+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;
+}
+export interface IndexedFile {
+    path: string;
+    hash: string;
+    lastModified: number;
+}
+export interface SymbolIndex {
+    functions: Map<string, string[]>;
+    classes: Map<string, string[]>;
+    exports: Map<string, string[]>;
+}
+export interface ImportGraph {
+    nodes: string[];
+    edges: [string, string][];
+}
+export interface DetectedPatterns {
+    frameworks: string[];
+    testFrameworks: string[];
+    buildTools: string[];
+}
+export declare function buildCodebaseIndex(_rootDir: string): Promise<CodebaseIndex>;
+export declare function searchIndex(_index: CodebaseIndex, _query: string): Promise<string[]>;
+//# sourceMappingURL=localExplore.d.ts.map