type McpToolResponse = {
    content: [{
        type: 'text';
        text: string;
    }];
    isError?: boolean;
};
export type ErrorMeta = {
    type: 'VALIDATION' | 'NOT_FOUND' | 'AUTH' | 'RATE_LIMIT' | 'INSUFFICIENT_FUNDS' | 'UNSUPPORTED' | 'HTTP' | 'API';
    code: string;
    retryable: boolean;
    recovery: string;
};
export declare function mcpText(text: string): McpToolResponse;
export declare function mcpError(text: string, meta?: ErrorMeta): McpToolResponse;
export declare function getErrorMessage(err: unknown): string;
export declare function isAddressError(msg: string): boolean;
export declare function isPaginationError(msg: string): boolean;
export declare function isNotFoundError(msg: string): boolean;
export declare function isHttp404Error(msg: string): boolean;
export declare function isHttp400Error(msg: string): boolean;
export declare function parseHttp400Messages(msg: string): string[] | null;
export declare function validateEnum(value: string, validOptions: readonly string[], context: string, fieldName: string): McpToolResponse | null;
type ErrorHandler = {
    match: (msg: string) => boolean;
    respond: (msg: string) => McpToolResponse;
};
export declare function handleToolError(err: unknown, fallbackPrefix: string, handlers?: ErrorHandler[]): McpToolResponse;
export declare function addressError(header: string, detail?: string): ErrorHandler;
export declare function paginationError(header: string, detail?: string): ErrorHandler;
export declare function notFoundError(header: string, detail?: string): ErrorHandler;
export declare function http404Error(header: string, detail: string): ErrorHandler;
export declare function http400Error(header: string): ErrorHandler;
export declare function isValidAddressFormat(address: string): boolean;
export declare function warnInvalidAddresses(paramName: string, addresses: string[]): string[];
export declare function warnInvalidAddress(paramName: string, address: string): string | null;
export declare function warnAddressConflicts(includeName: string, includeAddresses: string[] | undefined, excludeName: string, excludeAddresses: string[] | undefined): string | null;
export declare function missingParamError(toolName: string, recovery: string): McpToolResponse;
export declare function exclusiveParamError(toolName: string, paramA: string, paramB: string): McpToolResponse;
export declare function batchLimitError(toolName: string, max: number, actual: number): McpToolResponse;
export type { ErrorHandler, McpToolResponse };