import type { CanonicalJsonSchema } from "./types.js";
/**
 * Deterministic JSON serialization. Keys are sorted, numbers are compacted,
 * and primitive whitespace is normalized so identical logical objects produce
 * identical bytes. This is the source of stable, replay-safe hashes and the
 * foundation of the storm-breaker call fingerprint.
 */
export declare function canonicalStableStringify(value: unknown): string;
/** SHA-256 hex digest of UTF-8 bytes. */
export declare function sha256Hex(input: string): string;
/** Stable hash over any value via canonical serialization. */
export declare function stableHash(value: unknown): string;
/**
 * Deterministically canonicalize a JSON Schema so that semantically identical
 * schemas (eg. OpenAPI-style nullable vs JSON-Schema nullable) collapse to the
 * same logical shape. This is used for stable compatibility hashing and to
 * make `additionalProperties`/`required` handling predictable. It never drops
 * restrictions; it only normalizes representation.
 */
export declare function canonicalizeSchema(schema: CanonicalJsonSchema): CanonicalJsonSchema;
/**
 * Minimal structural validation of normalized arguments against a canonical
 * schema. This is intentionally conservative: it checks types, required
 * presence, enums, and additionalProperties=false restrictions. It is NOT a
 * full JSON-Schema engine; unsupported constructs fall back to permissive
 * (never to stricter) behavior so we never block a genuinely valid call, while
 * the repair layer separately refuses ambiguous destructive calls.
 */
export declare function validateAgainstSchema(args: Record<string, unknown>, schema: CanonicalJsonSchema): string[];
//# sourceMappingURL=canonicalize.d.ts.map