/**
 * Metadata Utilities
 *
 * Shared utilities for extracting request metadata from HTTP headers.
 */
import type { RequestMetadata } from './frontmcp-context';
/**
 * Extract request metadata from headers.
 *
 * @param headers - HTTP headers object
 * @returns Extracted metadata including user-agent, content-type, client IP, and custom headers
 */
export declare function extractMetadata(headers: Record<string, unknown>): RequestMetadata;
/**
 * Extract client IP from headers.
 *
 * Handles both string and array header values (some adapters pass arrays).
 * Supports x-forwarded-for (comma-separated list) and x-real-ip headers.
 *
 * @param headers - HTTP headers object
 * @returns Client IP address or undefined if not found
 */
export declare function extractClientIp(headers: Record<string, unknown>): string | undefined;
//# sourceMappingURL=metadata.utils.d.ts.map