StructuredPrompt interface exported

export interface StructuredPrompt<TInput, TOutput> {
  /** Unique identifier for this prompt (e.g. "field-classifier"). */
  readonly id: string;

  /** Semver-like version for auditing and cache-busting. */
  readonly version: string;

  /** Standard LLM role for this prompt (system, user, assistant). */
  readonly role: PromptRole;

  /** Persona/identity description the AI should adopt. */
  readonly persona: string;

  /** Concise task description — what the AI must accomplish. */
  readonly task: string;

  /** Ordered constraints the AI must follow (rendered as numbered rules). */
  readonly rules: readonly string[];

  /**
   * JSON output schema definition (field name, type, constraints).
   * Omit for prompts that expect plain-text responses (e.g. value generation).
   */
  readonly outputSchema?: readonly PromptOutputField[];

  /** Few-shot examples — (input context → expected output). */
  readonly examples?: readonly PromptExample[];

  /** Assembles the final prompt string from the given input context. */
  buildPrompt(input: TInput, userContext?: string): string;

  /** Parses raw AI text into TOutput, returning null on failure. */
  parseResponse(raw: string): TOutput | null;
}