import type { PromptHistoryEntry, PromptLabel, PromptStore, PromptVersion } from '../types/prompts.js';
/**
 * Prompts as files in a directory: one reviewable JSON file per version and per label, and one
 * history log per prompt.
 *
 * Meant to live in version control beside the code that uses the prompts, so a prompt change is a
 * diff in a pull request like any other. Writes go through a temporary file and a rename, so a reader
 * never sees half a file. Label compare-and-set is checked before writing, which protects one process
 * against itself; several processes promoting the same label at once need the Redis or Postgres store.
 *
 * Layout: `<directory>/<prompt>/versions/<version>.json`, `<prompt>/labels/<label>.json`, and
 * `<prompt>/history.jsonl`, with names URL-encoded.
 */
export declare class FilePromptStore implements PromptStore {
    private readonly directory;
    constructor(directory: string);
    /** Writes a version, unless its file exists. */
    saveVersion(version: PromptVersion): Promise<void>;
    /** Reads a version. */
    getVersion(name: string, version: string): Promise<PromptVersion | undefined>;
    /** Versions of a prompt, newest first. Defaults to 50. */
    listVersions(name: string, options?: {
        limit?: number;
    }): Promise<PromptVersion[]>;
    /** Reads a label. */
    getLabel(name: string, label: string): Promise<PromptLabel | undefined>;
    /** Every label of a prompt, sorted by name. */
    listLabels(name: string): Promise<PromptLabel[]>;
    /** Writes a label when it still points at `expected`. */
    setLabel(label: PromptLabel, expected?: string | null): Promise<boolean>;
    /** Removes a label. Resolves true when it existed. */
    deleteLabel(name: string, label: string): Promise<boolean>;
    /** Appends a change to the prompt's history log. */
    appendHistory(entry: PromptHistoryEntry): Promise<void>;
    /** A prompt's history, newest first, optionally for one label. Defaults to 100. */
    listHistory(name: string, options?: {
        label?: string;
        limit?: number;
    }): Promise<PromptHistoryEntry[]>;
    /** Every prompt name, sorted. */
    listNames(): Promise<string[]>;
    private promptDir;
    private versionFile;
    private labelFile;
}