import type { z } from 'zod';
/** Render a zod schema as a short type literal, e.g. `{explanation: string, evidenceRefs: string[]}`. */
export declare function describeZodShape(schema: unknown): string;
/** Walk a zod schema down `path` (object keys and array indices, as zod issue paths use),
 *  unwrapping optional/nullable/default at every step. Returns undefined if the path runs off
 *  a shape this can't follow (e.g. a catchall/record) — callers treat that as "no hint available". */
export declare function schemaAtPath(root: unknown, path: ReadonlyArray<PropertyKey>): unknown;
/** Enhance one zod issue's default message with the full expected shape of the field it's
 *  complaining about, read from the REAL schema — so an operator learns the whole contract from
 *  the first error, not "expected object" now and "unrecognized key" one failed attempt later. */
export declare function describePatchIssue(rootSchema: unknown, issue: z.ZodIssue): string;