import { Buffer } from 'buffer';
import { type GenerateRunDeps } from './generate.js';
import type { GenerationOutcome } from '../generate/stream.js';
export interface ReferenceRunDeps extends GenerateRunDeps {
    /** Seam over the generation lane, so a test drives this without a network or a token. */
    generate: (type: string, label: string, body: Record<string, unknown>, deps: GenerateRunDeps) => Promise<GenerationOutcome>;
    /** Returns whether the terminal actually drew the image. */
    renderImage: (bytes: Buffer) => boolean;
    /** The machine-readable result, emitted only under `--json`. */
    result: (value: unknown) => void;
}
/**
 * The prose the picture is drawn from: `--prompt` when given, otherwise GAME-DESIGN.md. The same
 * source `bitmagic cover` reads, because the two pictures describe the same game — but the error
 * paths name THIS command, since "write the design or pass --prompt" must say which command to
 * re-run.
 */
export declare function resolveReferenceDesignText(options: {
    promptFlag?: string | undefined;
    root: string;
}): string;
export interface ReferenceMakeArgs {
    prompt?: string;
    from?: string;
    'reference-image-url'?: string;
    /** A local image to steer this candidate by — uploaded first ("make the world like this photo"). */
    'reference-image'?: string;
    json?: boolean;
}
export declare function runReferenceMake(args: ReferenceMakeArgs, deps?: ReferenceRunDeps): Promise<void>;
export interface ReferenceAcceptArgs {
    candidate: string;
    json?: boolean;
}
export declare function runReferenceAccept(args: ReferenceAcceptArgs, deps?: ReferenceRunDeps): Promise<void>;
export interface ReferenceShowArgs {
    json?: boolean;
}
export declare function runReferenceShow(args: ReferenceShowArgs, deps?: ReferenceRunDeps): Promise<void>;
export declare function runReferenceClear(args: ReferenceShowArgs, deps?: ReferenceRunDeps): Promise<void>;
export declare const referenceCommand: import("citty").CommandDef<import("citty").ArgsDef>;