import type { JsonCoercionResult, ValidationSchema } from "../../types/index.js";
/**
 * Try to produce canonical JSON from `text`. Returns null when no JSON object
 * could be recovered (caller should then keep the raw text).
 *
 * When `schema` is a Zod schema, candidates that satisfy it are preferred; a
 * syntactically-valid-but-schema-failing object is still returned (we guarantee
 * JSON *validity*, leaving schema/content checks to the caller's own pipeline).
 */
export declare function coerceJsonToSchema(text: string, schema?: ValidationSchema): JsonCoercionResult | null;