import { pushCaptureEvent } from "./capture-store.js";
type FileWatchHandle = {
    stop: () => void;
};
/**
 * Seed an approved root into the graph without reading file contents. Symlinks
 * are skipped so inventory cannot escape the canonical root. A hard cap keeps
 * onboarding responsive for very large trees; later watcher events remain live.
 */
export declare function inventoryDirectory(dir: string, options?: {
    maxFiles?: number;
    onFile?: (event: Parameters<typeof pushCaptureEvent>[0]) => void;
}): Promise<{
    files: number;
    truncated: boolean;
}>;
/**
 * Watch a directory for file changes. Emits exact capture events with
 * file content or diffs for each change.
 */
export declare function watchDirectory(dir: string): FileWatchHandle;
export {};