/**
 * Format a "current state" block for injection into an LLM system prompt.
 *
 * Common pattern for form-fill agents (booking, lead capture, order intake):
 * on every turn, tell the model what has already been collected so it doesn't
 * re-ask. The block goes at the top of the system prompt as the source of
 * truth — the model is instructed to trust it over conversation history.
 *
 *   const state = formatStateBlock({
 *     label: 'BOOKING IN PROGRESS',
 *     fields: { day: '2026-08-01', time: null, party: 4 },
 *     labels: { day: 'Day', time: 'Time', party: 'Party size' },
 *     instructions: 'Do not re-ask any field already listed below.',
 *   });
 *   //
 *   // [BOOKING IN PROGRESS — Do not re-ask any field already listed below.]
 *   // - Day: 2026-08-01
 *   // - Party size: 4
 *
 * Empty / null / undefined values are skipped. If nothing renders, returns
 * an empty string so the caller can safely template it in unconditionally.
 */
export interface StateBlockOptions {
    label: string;
    fields: Record<string, unknown>;
    /** Pretty display name per field key. Missing keys fall back to the raw key. */
    labels?: Record<string, string>;
    /** Trailing instruction appended after the label. */
    instructions?: string;
    /** Custom value renderer. Default: booleans → "sim"/"não" is opinionated; use this to change. */
    formatValue?: (value: unknown, key: string) => string;
    /** Predicate: return true to skip. Default skips null / undefined / empty string / empty array. */
    skip?: (value: unknown, key: string) => boolean;
}
export declare function formatStateBlock(opts: StateBlockOptions): string;
//# sourceMappingURL=state_block.d.ts.map