/**
 * Robust JSON parsing helpers with actionable error messages.
 *
 * Used for --data, --kwargs, --args, --context flags.
 */
export declare class JsonArgError extends Error {
    readonly source: string;
    readonly cause?: Error | undefined;
    constructor(message: string, source: string, cause?: Error | undefined);
}
/**
 * Parse a JSON string argument with a helpful error message.
 *
 * @param raw   - Raw string from CLI flag
 * @param flag  - Flag name for error context (e.g., '--data')
 */
export declare function parseJsonArg(raw: string, flag?: string): Record<string, any>;
/**
 * Parse a JSON array argument.
 *
 * @param raw   - Raw string from CLI flag
 * @param flag  - Flag name for error context (e.g., '--args')
 */
export declare function parseJsonArray(raw: string, flag?: string): any[];
/**
 * Read JSON from a file path, or stdin when filePath is '-'.
 *
 * @param filePath - File path or '-' for stdin
 * @param flag     - Flag name for error context
 */
export declare function readJsonFile(filePath: string, flag?: string): Promise<Record<string, any>>;
/**
 * Read stdin as a string.
 */
export declare function readStdin(): Promise<string>;
/**
 * Read a text message from a file or stdin.
 */
export declare function readMessageFile(filePath: string): Promise<string>;
/**
 * Parse hours from "1.5" or "1:30" format.
 */
export declare function parseHours(raw: string): number;
/**
 * Parse comma-separated IDs into an array of numbers.
 */
export declare function parseIds(raw: string): number[];
//# sourceMappingURL=json-arg.d.ts.map