/**
 * project-access.js — 项目数据访问工具 (5)
 *
 * 1. search_project_code    搜索项目源码
 * 2. read_project_file      读取项目文件
 * 2b. list_project_structure 列出项目目录结构
 * 2c. get_file_summary       文件结构摘要
 * 2d. semantic_search_code   语义知识搜索
 */
/** 项目文件缓存条目 */
interface ProjectFile {
    relativePath?: string;
    path?: string;
    name?: string;
    content?: string;
}
/** 工具间共享状态（可挂载到 ctx 或 ctx._sharedState） */
interface ToolSharedState {
    _searchCache?: Map<string, SearchCacheEntry>;
    _readCache?: Map<string, ReadCacheEntry>;
    _searchCallCount?: number;
    [key: string]: unknown;
}
/** 工具上下文 */
export interface ToolContext extends ToolSharedState {
    projectRoot?: string;
    fileCache?: ProjectFile[] | null;
    container?: {
        get(name: string): unknown;
    } | null;
    _sharedState?: ToolSharedState;
    source?: string;
}
/** 搜索缓存条目 */
export interface SearchCacheEntry {
    matches: SearchMatch[];
    total: number;
    _cached?: boolean;
}
/** 搜索匹配项 */
export interface SearchMatch {
    file: string;
    line: number;
    code: string;
    context: string;
    score: number;
}
/** 读取缓存条目 */
export interface ReadCacheEntry {
    content?: string;
    totalLines?: number;
    language?: string;
    error?: string;
    _cached?: boolean;
}
/** 文件摘要结果 */
export interface FileSummaryResult {
    filePath: string;
    language: string;
    lineCount: number;
    imports: string[];
    declarations: string[];
    methods: string[];
    properties: string[];
    preview?: string;
}
/** 文件过滤参数 */
interface FileFilterParams {
    fileFilter?: string;
}
/** search_project_code 参数 */
export interface SearchCodeParams extends FileFilterParams {
    pattern?: string;
    patterns?: string[];
    isRegex?: boolean;
    contextLines?: number;
    maxResults?: number;
    query?: string;
    search?: string;
    keyword?: string;
    search_query?: string;
}
/** read_project_file 参数 */
export interface ReadFileParams extends FileFilterParams {
    filePath?: string;
    filePaths?: string[];
    startLine?: number;
    endLine?: number;
    maxLines?: number;
    path?: string;
    file_path?: string;
    filepath?: string;
    file?: string;
    filename?: string;
}
/** list_project_structure 参数 */
export interface ListStructureParams {
    directory?: string;
    depth?: number;
    includeStats?: boolean;
}
/** get_file_summary 参数 */
export interface FileSummaryParams {
    filePath?: string;
    file_path?: string;
    path?: string;
    file?: string;
}
/** semantic_search_code 参数 */
export interface SemanticSearchParams {
    query?: string;
    search?: string;
    keyword?: string;
    topK?: number;
    category?: string;
    language?: string;
}
/** 三方库路径识别 — 从 LanguageProfiles 统一派生 */
export declare const THIRD_PARTY_RE: RegExp;
/** 源码文件扩展名 — 从 LanguageService 统一派生 */
export declare const SOURCE_EXT_RE: RegExp;
export declare const searchProjectCode: {
    name: string;
    description: string;
    parameters: {
        type: string;
        properties: {
            pattern: {
                type: string;
                description: string;
            };
            patterns: {
                type: string;
                items: {
                    type: string;
                };
                description: string;
            };
            isRegex: {
                type: string;
                description: string;
            };
            fileFilter: {
                type: string;
                description: string;
            };
            contextLines: {
                type: string;
                description: string;
            };
            maxResults: {
                type: string;
                description: string;
            };
        };
        required: never[];
    };
    handler: (params: SearchCodeParams, ctx: ToolContext) => Promise<{
        hint: string;
        matches: SearchMatch[];
        total: number;
        searchedFiles: number;
        skippedThirdParty: number;
    } | {
        hint?: undefined;
        matches: SearchMatch[];
        total: number;
        searchedFiles: number;
        skippedThirdParty: number;
    } | {
        _deduped?: number | undefined;
        hint?: string | undefined;
        batchResults: Record<string, SearchCacheEntry>;
        patternsSearched: number;
        searchedFiles: number;
        error?: undefined;
        matches?: undefined;
        total?: undefined;
    } | {
        error: string;
        matches: never[];
        total: number;
    } | {
        _cached: boolean;
        hint: string;
        matches?: SearchMatch[] | undefined;
        total?: number | undefined;
        error?: undefined;
    }>;
};
export declare const readProjectFile: {
    name: string;
    description: string;
    parameters: {
        type: string;
        properties: {
            filePath: {
                type: string;
                description: string;
            };
            filePaths: {
                type: string;
                items: {
                    type: string;
                };
                description: string;
            };
            startLine: {
                type: string;
                description: string;
            };
            endLine: {
                type: string;
                description: string;
            };
            maxLines: {
                type: string;
                description: string;
            };
        };
        required: never[];
    };
    handler: (params: ReadFileParams, ctx: ToolContext) => Promise<{
        filePath: string;
        totalLines: number;
        startLine: number;
        endLine: number;
        content: string;
        language: string;
    } | {
        _deduped?: number | undefined;
        hint?: string | undefined;
        batchResults: Record<string, ReadCacheEntry>;
        filesRead: number;
        error?: undefined;
    } | {
        error: string;
    } | {
        _cached: boolean;
        hint: string;
        content?: string;
        totalLines?: number;
        language?: string;
        error?: string;
    }>;
};
export declare const listProjectStructure: {
    name: string;
    description: string;
    parameters: {
        type: string;
        properties: {
            directory: {
                type: string;
                description: string;
            };
            depth: {
                type: string;
                description: string;
            };
            includeStats: {
                type: string;
                description: string;
            };
        };
    };
    handler: (params: ListStructureParams, ctx: ToolContext) => Promise<{
        error: string;
        directory?: undefined;
        tree?: undefined;
        stats?: undefined;
    } | {
        directory: string;
        tree: string;
        stats: {
            totalFiles: number;
            totalDirs: number;
            byLanguage: Record<string, number>;
            totalLines: number;
        } | undefined;
        error?: undefined;
    }>;
};
export declare const getFileSummary: {
    name: string;
    description: string;
    parameters: {
        type: string;
        properties: {
            filePath: {
                type: string;
                description: string;
            };
        };
        required: string[];
    };
    handler: (params: FileSummaryParams, ctx: ToolContext) => Promise<FileSummaryResult | {
        error: string;
    }>;
};
export declare const semanticSearchCode: {
    name: string;
    description: string;
    parameters: {
        type: string;
        properties: {
            query: {
                type: string;
                description: string;
            };
            topK: {
                type: string;
                description: string;
            };
            category: {
                type: string;
                description: string;
            };
            language: {
                type: string;
                description: string;
            };
        };
        required: string[];
    };
    handler: (params: SemanticSearchParams, ctx: ToolContext) => Promise<{
        error: string;
        fallbackTool?: undefined;
        mode?: undefined;
        query?: undefined;
        message?: undefined;
        results?: undefined;
        degraded?: undefined;
        totalResults?: undefined;
    } | {
        error: string;
        fallbackTool: string;
        mode?: undefined;
        query?: undefined;
        message?: undefined;
        results?: undefined;
        degraded?: undefined;
        totalResults?: undefined;
    } | {
        mode: string;
        query: string;
        message: string;
        results: {
            id: string;
            content: string;
            score: number;
            metadata: Record<string, unknown>;
        }[];
        error?: undefined;
        fallbackTool?: undefined;
        degraded?: undefined;
        totalResults?: undefined;
    } | {
        mode: string;
        query: string;
        results: {
            id: string;
            content: string;
            score: number;
            metadata: Record<string, unknown>;
        }[];
        error?: undefined;
        fallbackTool?: undefined;
        message?: undefined;
        degraded?: undefined;
        totalResults?: undefined;
    } | {
        mode: string;
        query: string;
        degraded: boolean;
        totalResults: number;
        results: {
            id: string;
            title: string;
            content: string;
            score: number;
            knowledgeType: string;
            category: string;
            language: string;
        }[];
        error?: undefined;
        fallbackTool?: undefined;
        message?: undefined;
    }>;
};
export {};