/**
 * Brief enhancement utilities.
 *
 * Calls `client.content.brief()` to refine a rough user-written prompt into
 * an optimized generation prompt.  Also builds a silent metadata enrichment
 * object from document context so the Lamina API receives richer signals
 * without changing what the user sees in the text field.
 *
 * Closes #66.
 */
import type { LaminaClient } from '@uselamina/sdk';
export interface EnhanceResult {
    /** The optimized prompt text. */
    enhanced: string;
    /** Title of the concept (for display). */
    title: string;
    /** Short rationale explaining the enhancement. */
    rationale: string;
}
/**
 * Ask the Lamina API to rewrite `rawBrief` into a higher-quality prompt.
 * Returns `null` if the API fails (enhancement is best-effort).
 */
export declare function enhanceBrief(client: LaminaClient, rawBrief: string, context: {
    modality?: string;
    brandProfileId?: string;
    documentType?: string;
    documentTitle?: string;
    fieldName?: string;
    documentExcerpt?: string;
}): Promise<EnhanceResult | null>;
export interface SilentEnrichment {
    metadata: Record<string, string>;
}
/**
 * Build a metadata bag from document context that is sent alongside the
 * generation request.  This enriches the API call without being visible
 * in the brief textarea.
 */
export declare function buildSilentEnrichment(context: {
    documentType?: string;
    documentTitle?: string;
    fieldName?: string;
    fieldDescription?: string;
    documentExcerpt?: string;
    brandProfileName?: string;
    targetDimensions?: string;
    platform?: string;
}): SilentEnrichment;