import { ForgeOSClient } from "./client.js";
export interface NegotiateRequest {
    cli_version: string;
    schema_version: number;
    api_schema: string;
}
export interface NegotiateResponse {
    status: "compatible" | "upgrade_recommended" | "incompatible";
    engine_version: string;
    api_schema: string;
    cli_expected_version: string;
    message: string | null;
    upgrade_url: string;
    deprecated_features: string[];
    sunset_date: string | null;
}
/**
 * Call POST /api/negotiate on the engine. Returns null if engine is
 * unreachable (never blocks startup). Caches result for 1 hour.
 */
export declare function checkCompatibility(client: ForgeOSClient, schemaVersion: number): Promise<NegotiateResponse | null>;
/**
 * Print a user-facing warning based on negotiate response.
 * - compatible: no output
 * - upgrade_recommended: yellow warning with upgrade command
 * - incompatible: red error, suggest upgrade, exit(1)
 */
export declare function handleCompatResult(result: NegotiateResponse): void;
//# sourceMappingURL=compat.d.ts.map