import { z, ZodSchema } from 'zod';
export interface JsonOutputOptions<T> {
    system?: string;
    maxTokens?: number;
    maxRetries?: number;
    featureName?: string;
    fallback?: T;
    /** Extra instruction to append — e.g. "Respond ONLY with JSON matching {...}". */
    schemaHint?: string;
    /** Cache identical requests (default: true). */
    useCache?: boolean;
}
/**
 * Ask the LLM for JSON that satisfies a Zod schema.
 * Returns parsed T, or opts.fallback if every retry failed.
 */
export declare function generateJson<T>(prompt: string, schema: ZodSchema<T>, opts?: JsonOutputOptions<T>): Promise<{
    value: T;
    provider: string;
    model: string;
    attempts: number;
    cached?: boolean;
}>;
/** Re-export Zod for downstream brain modules that want to define schemas. */
export { z };
//# sourceMappingURL=json-output.d.ts.map