/**
 * Tool handlers for clustering operations.
 */
import type { CodeIndexer, CodeChunk, CodebaseSummary } from '../search/indexer.js';
import type { ConceptCluster } from '../search/clustering.js';
import type { ToolResponse } from './types.js';
/**
 * Context for clustering tools.
 */
export interface ClusteringToolContext {
    indexer: CodeIndexer;
    toolGuidance: string;
}
/**
 * Arguments for summarize_codebase tool.
 */
export interface SummarizeCodebaseArgs {
    numClusters?: number;
}
/**
 * Parse and validate summarize_codebase arguments.
 */
export declare function parseSummarizeCodebaseArgs(args: Record<string, unknown> | undefined): SummarizeCodebaseArgs;
/**
 * Format codebase summary for display.
 */
export declare function formatCodebaseSummary(summary: CodebaseSummary): string;
/**
 * Handle summarize_codebase tool.
 */
export declare function handleSummarizeCodebase(args: SummarizeCodebaseArgs, context: ClusteringToolContext): Promise<ToolResponse>;
/**
 * Arguments for list_concepts tool.
 */
export interface ListConceptsArgs {
    forceRecluster?: boolean;
}
/**
 * Parse and validate list_concepts arguments.
 */
export declare function parseListConceptsArgs(args: Record<string, unknown> | undefined): ListConceptsArgs;
/**
 * Format concept clusters for display.
 */
export declare function formatConceptClusters(concepts: ConceptCluster[]): string;
/**
 * Handle list_concepts tool.
 */
export declare function handleListConcepts(args: ListConceptsArgs, context: ClusteringToolContext): Promise<ToolResponse>;
/**
 * Arguments for search_by_concept tool.
 */
export interface SearchByConceptArgs {
    conceptId: number;
    query?: string;
    limit?: number;
}
/**
 * Parse and validate search_by_concept arguments.
 */
export declare function parseSearchByConceptArgs(args: Record<string, unknown> | undefined): SearchByConceptArgs;
/**
 * Format concept search results for display.
 */
export declare function formatConceptSearchResults(results: CodeChunk[], conceptId: number): string;
/**
 * Handle search_by_concept tool.
 */
export declare function handleSearchByConcept(args: SearchByConceptArgs, context: ClusteringToolContext): Promise<ToolResponse>;
//# sourceMappingURL=clustering-handlers.d.ts.map