/**
 * A failed request, carrying what the daemon said about it.
 *
 * The daemon answers a failure with a human-readable `error` and a stable
 * machine-readable `code`. Clients branch on `code`; the set grows with the
 * product, and an unrecognized code is treated by its status class. The message
 * text is for display and logs and must never be matched on.
 */
export declare class HappyAgentApiError extends Error {
    /** The HTTP status the daemon answered with. */
    readonly status: number;
    /** The stable snake_case failure name, when the daemon named one. */
    readonly code: string | null;
    /**
     * The whole error body.
     *
     * Endpoints document extra fields alongside `error` and `code`: the
     * `If-Match` conflict carries `currentVersion` and the authoritative
     * resource, a lost event cursor carries the cursor to resume from, and a
     * file-write conflict carries the file's current `hash`.
     */
    readonly body: ApiErrorBody | null;
    constructor(status: number, message: string, code: string | null, body: ApiErrorBody | null);
}
/** The JSON body of a failed request. */
export interface ApiErrorBody {
    /** A human-readable English message, for display and logs. */
    error?: string;
    /** A stable, machine-readable snake_case name for the failure. */
    code?: string;
    [field: string]: unknown;
}
/**
 * Reads a failed response into an error.
 *
 * A daemon that failed before it could write JSON — or a proxy in front of it
 * that answered instead — still produces a usable error, so the body is read
 * defensively rather than assumed.
 */
export declare function readApiError(response: Response): Promise<HappyAgentApiError>;
//# sourceMappingURL=HappyAgentApiError.d.ts.map