/**
 * Shape of the discovery file written by the obsidian-brain-companion plugin
 * at `{VAULT}/.obsidian/plugins/obsidian-brain-companion/discovery.json`.
 */
export interface DiscoveryRecord {
    port: number;
    token: string;
    pid: number;
    pluginVersion: string;
    startedAt: number;
    /**
     * Feature capabilities the plugin version exposes. Used to gate
     * capability-requiring tools before any HTTP call — e.g. `dataview_query`
     * requires `"dataview"`. Older plugins (<= 0.1.x) that don't write this
     * field are treated as `["status", "active"]`.
     */
    capabilities: string[];
}
export declare function discoveryFilePath(vaultPath: string): string;
/**
 * Load and validate the discovery file. Returns `null` when the file is
 * missing, unreadable, or malformed — callers treat all of these the same
 * way ("plugin not available").
 */
export declare function readDiscovery(vaultPath: string): Promise<DiscoveryRecord | null>;