import type { CatalogErrorKind } from "./types.js";
export type SecretErrorCode = "unsupported-store" | "invalid-reference" | "missing" | "empty";
/** Error whose public text is safe to show in diagnostics. */
export declare class SecretResolutionError extends Error {
    readonly code: SecretErrorCode;
    constructor(code: SecretErrorCode, message: string);
}
export declare class NineRouterError extends Error {
    readonly kind: CatalogErrorKind;
    readonly stage: string;
    readonly status?: number;
    constructor(kind: CatalogErrorKind, stage: string, message: string, status?: number);
    toJSON(): {
        kind: CatalogErrorKind;
        stage: string;
        message: string;
        status?: number;
    };
}
export declare function safeCatalogErrorStage(stage: string): string;
/** Never persist or display arbitrary provider/network error text. */
export declare function safeCatalogErrorMessage(error: Pick<NineRouterError, "kind" | "status">): string;
export type ManagerErrorCode = "not-configured" | "gateway-disabled" | "catalog-empty" | "model-not-found" | "model-ambiguous" | "active-route" | "provider-unavailable" | "route-id-collision";
export declare class NineRouterManagerError extends Error {
    readonly code: ManagerErrorCode;
    constructor(code: ManagerErrorCode, message: string);
}