import { type Router as ExpressRouter } from "express";
export type { FsDirEntry, FsListResponse } from "../shared/types.js";
/** The OS command that shows `target` in the file manager, as argv (no shell). */
export interface RevealCommand {
    command: string;
    args: string[];
    /** Windows only: pass `args` through unquoted (see `revealCommand`). */
    windowsVerbatimArguments?: boolean;
}
/**
 * macOS and Windows select the folder inside its parent; Linux has no portable
 * "select" verb, so `xdg-open` opens the folder itself (the card labels it
 * "Open folder" there).
 */
export declare function revealCommand(target: string, platform: NodeJS.Platform): RevealCommand;
export interface FsRouterDeps {
    /**
     * The workflow registry's own path for the agent folder at `resolvedPath`,
     * or null when no registered agent lives there. The reveal route acts only
     * on these: it runs an OS command, so it must not take arbitrary paths, and
     * it uses the registry's string rather than the request's from here on.
     * Absent, every reveal is refused (403).
     */
    findAgentPath?: (resolvedPath: string) => string | null | Promise<string | null>;
    /** Injectable for tests; defaults to spawning the platform command detached. */
    reveal?: (cmd: RevealCommand) => void | Promise<void>;
    /** Injectable for tests; defaults to `process.platform`. */
    platform?: NodeJS.Platform;
}
export declare function createFsRouter(deps?: FsRouterDeps): ExpressRouter;
//# sourceMappingURL=fs.d.ts.map