import type { ActionSchema } from './action-schema.js';
export interface PersonaDialogExample {
    readonly user: string;
    readonly assistant: string;
}
export interface PersonaCurrentLifeSpec {
    readonly description?: string;
}
export interface PersonaPersonalitySpec {
    readonly traits?: readonly string[];
    readonly description?: string;
}
export interface PersonaSpec {
    /** Display name of the character (injected into the system prompt). */
    readonly name: string;
    /** One-line persona summary. */
    readonly summary?: string;
    /** One-line present-day role or social identity. */
    readonly role?: string;
    /** Present-tense grounding for what fills the character's life right now. */
    readonly currentLife?: PersonaCurrentLifeSpec;
    /** Minimal, designer-friendly personality authoring surface. */
    readonly personality?: PersonaPersonalitySpec;
    /** Optional short grounding about the character's past. */
    readonly backstory?: string;
    /**
     * Static notes that become part of the system prompt every turn. Useful
     * for character-specific constraints that do not fit a structured section.
     */
    readonly notes?: readonly string[];
    /**
     * Optional high-priority examples rendered directly into the system prompt.
     * Use these sparingly for durable identity, scope, and refusal steering.
     */
    readonly anchorExamples?: readonly PersonaDialogExample[];
    /**
     * Optional few-shot examples that demonstrate how the configured character
     * should respond in conversation. They are replayed as few-shot turns each
     * turn, but are not mirrored into the system prompt.
     */
    readonly dialogExamples?: readonly PersonaDialogExample[];
}
/**
 * Renders the persona + action schema into a single system prompt string.
 * The prompt is deterministic given the same inputs, which lets the runtime
 * key the prefix KV cache on the character id and reuse it across turns.
 */
export declare function renderSystemPrompt(persona: PersonaSpec, schema: ActionSchema): string;