/**
 * Project file search for the agent composer `@` mention dropdown.
 *
 * `GET /api/projects/:id/files/search?query=<query>` returns files whose
 * relative path contains the query (case-insensitive). Results are limited
 * to `MAX_RESULTS` and common generated directories are always excluded.
 *
 * The handler is synchronous-style but returns a Promise because `glob`
 * exposes an async API.
 */
import type { SessionStore } from "../storage.js";
export interface ProjectFileSearchResult {
    /** Absolute filesystem path. */
    path: string;
    /** Path relative to the project root (POSIX separators). */
    relativePath: string;
    /** Filename (basename). */
    name: string;
}
/**
 * Search files in a project whose relative path contains `query`
 * (case-insensitive). Returns an empty array when the project has no
 * files, when the query is empty, or when the project path is unreadable.
 */
export declare function handleSearchProjectFiles(store: SessionStore, projectId: string, query: string): Promise<ProjectFileSearchResult[]>;
//# sourceMappingURL=files-search.d.ts.map