interface CliErrorOptions {
    code?: string;
    exitCode?: number;
    details?: unknown;
    cause?: unknown;
}
export interface CliArgDefinition {
    type: 'positional' | 'string' | 'boolean';
    alias?: string | string[];
    description?: string;
    required?: boolean;
    default?: unknown;
}
export declare class CliError extends Error {
    readonly code: string;
    readonly exitCode: number;
    readonly details?: unknown;
    constructor(message: string, options?: CliErrorOptions);
}
export declare function fail(message: string, options?: CliErrorOptions): never;
export declare function printJson(value: Record<string, unknown>): void;
export declare function runWithContract<T>(options: {
    json: boolean;
}, task: () => Promise<T> | T): Promise<T>;
export declare function handleCommandError(error: unknown, json: boolean): never;
export declare function assertNoUnknownFlags(rawArgs: string[], argsDefinition: Record<string, CliArgDefinition>): void;
export declare function isOptionProvided(rawArgs: string[], name: string, alias?: string | string[]): boolean;
export declare function parseEnumArg<T extends string>(optionName: string, value: unknown, allowedValues: readonly T[]): T;
export declare function parsePositiveNumberArg(optionName: string, value: unknown): number;
export {};