import type { ConnectedPeer } from "@sideband/cloud";
import type { MethodMeta } from "./rpc-meta.js";
export interface FsEntry {
    name: string;
    type: "file" | "directory";
    size: number | null;
    modified: string;
}
/** Display name for a canonical root — basename, or the full path when basename is empty (e.g. "/"). */
export declare function fsDisplayName(canonicalRoot: string): string;
/**
 * Registers $sideband/fs.list and $sideband/fs.read handlers for the given peer.
 * Both handlers are scoped to the provided root directory.
 *
 * canonicalRoot is resolved once at registration time (not per request) to avoid
 * race conditions with symlink changes to the root itself.
 *
 * Returns the capability descriptor to be merged into $sideband/info capabilities.
 */
export declare function registerFsHandlers(peer: ConnectedPeer, root: string, allowDotfiles: boolean): Promise<{
    fs: {
        name: string;
        write: false;
    };
}>;
export declare const fsMeta: Record<string, MethodMeta>;
//# sourceMappingURL=fs.d.ts.map