/**
 * CLI-authored hints for One errors the CLI recognises. They are chosen only
 * from the request (method, route, whether a customer was selected), the HTTP
 * status and One's own error codes. One's free-text messages are never shown:
 * they can describe its configuration.
 */
export declare const STAFF_CUSTOMER_SCOPE_HINT = "Vigilbase staff: add --customer-id <uuid>.";
export declare const PERSONAL_SETTINGS_HINT = "Personal settings belong to each user, so View-as (--customer-id) cannot read them.";
export declare const BROWSER_SESSION_HINT = "Invitations need a One browser session: manage them at https://one.vigilbase.com.";
export type OneErrorContext = {
    method: string;
    /** The One path the CLI requested, with its query string. */
    path: string;
    status: number;
    code?: string;
    /** Whether the request named a customer; defaults to a `customerId` query parameter. */
    hasCustomerScope?: boolean;
};
export declare function oneErrorHint(context: OneErrorContext): string | undefined;