/**
 * Reference validation utilities
 */
export declare const UNNAMED_CONNECTION = "unnamed-connection-default";
export declare const RESERVED_REFERENCES: string[];
/**
 * Sanitize a reference string to a consistent format
 * Converts "Test Payment Flow" -> "test-payment-flow"
 */
export declare function sanitizeReference(ref: string): string;
/**
 * Validate a reference string (legacy API)
 * Returns the sanitized reference if valid, or an error if invalid
 *
 * Accepts both formats:
 * - "test replay feature" (3 space-separated words)
 * - "test-replay-feature" (already sanitized, 3 hyphen-separated parts)
 */
export declare function validateReference(ref: string): {
    valid: boolean;
    sanitized?: string;
    error?: string;
};
/**
 * Error class for invalid references - contains the MCP error response
 */
export declare class InvalidReferenceError extends Error {
    readonly response: {
        content: {
            type: string;
            text: string;
        }[];
    };
    constructor(error: string);
}
/**
 * Validate and return sanitized reference, or throw InvalidReferenceError
 * Use this in tool handlers - throws if invalid, returns sanitized string if valid
 */
export declare function requireValidReference(ref: string): string;
//# sourceMappingURL=reference-validator.d.ts.map