/**
 * Loud error types. Every failure surfaces — a failed request or a schema
 * mismatch throws, so the UI can render a visible error state, never a silent
 * empty render.
 */
/** The skeleton returned `{ "error": "<message>" }` (or a non-2xx status). */
export declare class ApiError extends Error {
    readonly status: number;
    /** The optional machine-readable `code` from the `{ error, code }` envelope. */
    readonly code: string | undefined;
    /**
     * The response's `Retry-After` delay in seconds, when it carried one (the
     * retriable reloading `503` does). A caller that retries waits this long; a
     * caller that does not ignores it.
     */
    readonly retryAfterSeconds?: number;
    /**
     * The full parsed error body (`{ error, code, …extra }`), when the failure carried a
     * JSON body. Operations spread structured follow-up data beside the message (e.g. a
     * reconcile refusal's `{ reconcile: true, orphans: [...] }`), so a UI keys its
     * follow-up on this DATA, not on the prose. `undefined` when the body was not JSON.
     */
    readonly body?: unknown;
    constructor(message: string, status: number, code?: string, retryAfterSeconds?: number, body?: unknown);
}
/** A 401 from any data route. The shell routes this back to `/login`. */
export declare class ApiUnauthorizedError extends ApiError {
    constructor(message?: string);
}
/** A duplicate answer / alias collision etc. (HTTP 409). */
export declare class ApiConflictError extends ApiError {
    constructor(message: string, body?: unknown);
}
/**
 * A login attempt was REJECTED (bad credentials, expired invite/SSO code,
 * rate-limited). Deliberately NOT an ApiUnauthorizedError: that type means "your
 * stored session credential is dead" and routes to /login globally (the
 * create-studio wiring); this one means "the credentials you just typed on the
 * login page were refused" and renders inline, on the page the user is already
 * on.
 */
export declare class ApiLoginFailedError extends Error {
    readonly status: number;
    constructor(message: string, status: number);
}
/**
 * A setup attempt was REJECTED — a bad or throttled token (403/429), an
 * already-initialized deployment (409), an unsupported setup door (501), or an
 * invalid body (400/422). Like {@link ApiLoginFailedError} it is NOT an
 * ApiUnauthorizedError: it renders inline on the setup entry, keyed on `status`
 * so the page shows the right copy, never a global unauthorized redirect.
 */
export declare class ApiSetupFailedError extends Error {
    readonly status: number;
    constructor(message: string, status: number);
}
/**
 * The response body did not match its declared zod schema. This is a contract
 * drift between the Studio and the skeleton — a loud, visible error, never a
 * silently-coerced value.
 */
export declare class ApiSchemaError extends Error {
    readonly endpoint: string;
    readonly issues: unknown;
    constructor(endpoint: string, issues: unknown);
}
//# sourceMappingURL=errors.d.ts.map