export declare const DEFAULT_PARTITION_THRESHOLD = 80;
export type PartitionAxis = "cluster" | "directory" | "symbol_neighborhood";
export interface PartitionBucket {
    label: string;
    filter: Record<string, string>;
    est_count: number;
    sample: string[];
}
export interface PartitionPlan {
    axis: PartitionAxis;
    total: number;
    buckets: PartitionBucket[];
    note: string;
}
export interface PartitionInput {
    path: string;
    clusterId?: number | null;
    clusterName?: string | null;
}
export interface PartitionClusterInfo {
    id: number;
    name: string;
}
/**
 * Decide how to partition a large result list. `threshold` is the point
 * above which we fall back from raw dump to a plan.
 */
export declare function partitionPlan(items: PartitionInput[], opts?: {
    threshold?: number;
    clusters?: PartitionClusterInfo[];
    axisPreference?: PartitionAxis;
}): PartitionPlan | null;
export declare function formatPlan(plan: PartitionPlan): string;