/**
 * Custom help formatting for the CLI.
 *
 * Overrides commander's default help layout to show Commands before Options,
 * and applies consistent conventions (short -h flag, no implicit help subcommand).
 */
import type { Command } from 'commander';
/** Description of a named command group rendered as its own section in help output. */
export interface CommandGroup {
    /** Section heading, e.g. 'Bundle commands'. */
    title: string;
    /** Subcommand names (in desired display order) that belong to this group. */
    names: readonly string[];
}
/**
 * Register named groups for a parent command so its help output splits the
 * Commands section into multiple labeled sections. Subcommands not listed in
 * any group fall back to a plain "Commands:" section below the groups.
 */
export declare function registerCommandGroups(parent: Command, groups: readonly CommandGroup[]): void;
/**
 * Front-door command groups shown on `agents --help`. Derived from measured
 * reach: tier 1 = setup/run/sessions/view, tier 2 = teams/browser/secrets/
 * devices/accounts/add. The remaining groups stay discoverable through the
 * pointer rendered below these groups.
 */
export declare const FRONT_DOOR_COMMAND_GROUPS: readonly CommandGroup[];
/** Mark the root program so its help only renders front-door groups + a pointer. */
export declare function setCompactRootHelp(program: Command): void;
/** Examples + Notes blocks attached to a command via setHelpSections. */
export interface HelpSections {
    examples?: string;
    notes?: string;
}
/**
 * Attach an Examples block (rendered between the description and Arguments)
 * and/or a Notes block (rendered at the very end, after Options) to a command.
 *
 * Bodies are normalized: the shared leading indent is stripped, then every line
 * is re-indented by two spaces. Callers can pass natural multiline template
 * literals without babysitting whitespace.
 */
export declare function setHelpSections(cmd: Command, sections: HelpSections): void;
/** Read the workflow-first sections attached to a command for generated references. */
export declare function getHelpSections(cmd: Command): Readonly<HelpSections>;
/** Apply standardized help formatting to the root command and all subcommands. */
export declare function applyGlobalHelpConventions(root: Command): void;
