/**
 * The `ls` capability: enumerate the immediate contents of a directory.
 *
 * The directory's children are pulled through the {@link Fs} backend, and each
 * one is `stat`-ed so the listing can report a concrete kind (file, directory,
 * symlink, or other) and a byte size alongside its bare name. By default,
 * dot-prefixed entries are hidden, matching the convention most shells follow;
 * the caller can opt into seeing them. The rendered table is bounded by the
 * context's {@link OutputBudget} so a very large folder cannot overrun the
 * model's window.
 *
 * Authored entirely against the kernel surface — directory walking and metadata
 * lookups go through `ctx.fs`, and trimming goes through `ctx.budget` / `clamp`.
 * No Node API is reached for here.
 */
export declare const lsTool: import("..").DefinedTool;
