import type { CanonicalJsonSchema, SchemaEnvelope } from "./types.js";
/** Safety annotations we preserve verbatim on the provider-facing schema. */
declare const SAFETY_ANNOTATION_KEYS: string[];
export declare function measureSchemaDepth(schema: CanonicalJsonSchema, depth?: number): number;
/**
 * Build a provider-facing schema envelope. `flatten` is selected by the caller
 * based on provider capability and measured need, and recorded on the result.
 */
export declare function buildSchemaEnvelope(schema: CanonicalJsonSchema, opts?: {
    flatten?: boolean;
}): SchemaEnvelope;
/**
 * Decide a provider-facing flattening treatment while keeping canonical
 * validation authoritative. Returns a SchemaEnvelope.
 */
export declare function applyProviderSchemaCompatibility(canonicalSchema: CanonicalJsonSchema, providerCapability?: "flat" | "nested" | "unknown", forceFlatten?: boolean): SchemaEnvelope;
export declare function isSchemaUnsupported(envelope: SchemaEnvelope): boolean;
export { SAFETY_ANNOTATION_KEYS };
//# sourceMappingURL=schema-flatten.d.ts.map