/**
 * CLI argument parsing utilities.
 * Provides functions for parsing command-line arguments in skill scripts.
 */
/**
 * Parsed CLI arguments structure.
 */
export interface IParsedArgs {
    /** The command (first positional argument) */
    command: string;
    /** Remaining positional arguments joined as payload */
    payload: string;
    /** Named flags (--flag value or --flag) */
    flags: Map<string, string | true>;
}
/**
 * Pop a flag from the args array and return its value.
 * Mutates the args array by removing the flag and its value.
 *
 * @param args - The arguments array to modify
 * @param name - The flag name (e.g., '--group')
 * @param fallback - Default value if flag not found
 * @returns The flag value or fallback
 */
export declare function popFlag(args: string[], name: string, fallback: string): string;
export declare function popFlag(args: string[], name: string, fallback: null): string | null;
/**
 * Check if a boolean flag is present and remove it from args.
 * Mutates the args array by removing the flag.
 *
 * @param args - The arguments array to modify
 * @param name - The flag name (e.g., '--cache')
 * @returns True if flag was present
 */
export declare function hasFlag(args: string[], name: string): boolean;
/**
 * Parse all arguments into a structured format.
 * Does not mutate the input array.
 *
 * @param argv - Raw arguments (typically process.argv.slice(2))
 * @returns Parsed arguments structure
 */
export declare function parseArgs(argv: string[]): IParsedArgs;
/**
 * Get a string flag value from parsed args.
 *
 * @param flags - The flags map from parseArgs
 * @param name - The flag name (e.g., '--group')
 * @param fallback - Default value if not found
 */
export declare function getFlag(flags: Map<string, string | true>, name: string, fallback: string): string;
export declare function getFlag(flags: Map<string, string | true>, name: string, fallback: null): string | null;
/**
 * Check if a boolean flag is set in parsed args.
 *
 * @param flags - The flags map from parseArgs
 * @param name - The flag name (e.g., '--cache')
 */
export declare function hasArgFlag(flags: Map<string, string | true>, name: string): boolean;
//# sourceMappingURL=cli.d.ts.map