/**
 * Endpoint Configuration
 *
 * SPARC Architecture Reference: §2.4
 *
 * PURPOSE: Define downstream service endpoints
 *
 * FORBIDDEN:
 * - Business Logic
 * - Dynamic endpoint construction based on data
 *
 * LOCALHOST SAFEGUARD:
 * - By default, the CLI targets production Cloud Run endpoints
 * - If any endpoint URL resolves to localhost, the CLI will fail fast
 * - To enable local development, set AGENTICS_LOCAL_DEV=true explicitly
 * - This prevents accidental localhost usage in production
 */
import type { EndpointRegistry, EndpointConfig } from '../types/index.js';
/**
 * Check if local development mode is explicitly enabled.
 * Must be set to 'true' or '1' to enable localhost endpoints.
 */
export declare function isLocalDevMode(): boolean;
/**
 * Check if a URL points to localhost or 127.0.0.1
 */
export declare function isLocalhostUrl(url: string): boolean;
/**
 * Error thrown when localhost is used without explicit local development mode.
 */
export declare class LocalhostInProductionError extends Error {
    readonly serviceName: string;
    readonly url: string;
    constructor(serviceName: string, url: string);
}
/**
 * Validate that an endpoint URL is allowed based on the current mode.
 * Throws LocalhostInProductionError if localhost is used without local dev mode.
 */
export declare function validateEndpointUrl(serviceName: string, url: string): void;
export declare const DEFAULT_ENDPOINTS: EndpointRegistry;
/**
 * Load endpoint configuration for a specific service.
 * Validates that the endpoint URL is allowed (fails fast if localhost without local dev mode).
 *
 * @throws LocalhostInProductionError if localhost is used without AGENTICS_LOCAL_DEV=true
 */
export declare function loadEndpointConfig(serviceName: keyof EndpointRegistry, overrides?: Partial<EndpointConfig>): EndpointConfig;
/**
 * Load all endpoint configurations.
 * Validates that all endpoint URLs are allowed (fails fast if any localhost without local dev mode).
 *
 * @throws LocalhostInProductionError if any localhost is used without AGENTICS_LOCAL_DEV=true
 */
export declare function loadAllEndpoints(overrides?: Partial<EndpointRegistry>): EndpointRegistry;
/**
 * Get information about the current endpoint mode.
 * Useful for debugging and logging.
 */
export declare function getEndpointModeInfo(): {
    isLocalDev: boolean;
    mode: 'local' | 'production';
    description: string;
};
//# sourceMappingURL=endpoints.d.ts.map