import type { ReferenceSheet } from './types.js';
/**
 * Go Bananas style preset that renders the multi-view **Cinematic Character
 * Reference Sheet** (hero portrait + 6 reference views). Every auto-created
 * character gets one as its identity reference sheet — the consistency anchor
 * the rest of the pipeline (director identity gate, Seedance/Flow) depends on.
 */
export declare const CINEMATIC_CHARACTER_SHEET_PRESET_ID = 55;
export interface CharacterAutoCreateInput {
    name: string;
    description: string;
    style?: string;
}
/**
 * Build the canonical identity reference sheet for an auto-created character.
 * Pure/deterministic. Carries two `identity`-role references — the rendered
 * sheet image (project-relative path) and the managed Go Bananas character —
 * so the sheet satisfies the director identity gate and locks identity
 * downstream. Bindings/createdAt are preserved from `existing` on re-create.
 */
export declare function buildCharacterIdentitySheet(args: {
    name: string;
    characterId: number;
    sheetRelPath: string;
    now: string;
    existing?: ReferenceSheet;
}): ReferenceSheet;
export interface CharacterAutoCreateResult {
    characterId: number;
    imageUrl: string;
    created: boolean;
    importedToProject: boolean;
    /** Identity reference-sheet id, when one was generated + registered. */
    referenceSheetId?: string;
    /** Project-relative path to the rendered Cinematic Character Reference Sheet. */
    referenceSheetPath?: string;
    /** True when the identity sheet was merged into the Go Bananas character record. */
    gbRefsSynced?: boolean;
}
export declare function buildPortraitPrompt(input: CharacterAutoCreateInput): string;
/**
 * Prompt for the identity reference sheet. Leads with the character's `style`
 * (mirroring buildPortraitPrompt) so the sheet matches the portrait's look
 * rather than the sheet style preset's default — preset 55 ("Cinematic")
 * otherwise renders a 3D/photoreal sheet even for a flat-cartoon character,
 * leaving the identity anchor off-style from the portrait it should match.
 */
export declare function buildReferenceSheetPrompt(input: CharacterAutoCreateInput): string;
/**
 * Pure builder for the POST /images body that generates the reference sheet.
 * Carries the style (via buildReferenceSheetPrompt) and, when the on-style
 * portrait image id is known, passes it as `reference_image_ids` so the sheet
 * inherits the portrait's exact look instead of the preset's default style.
 */
export declare function buildReferenceSheetRequestBody(args: {
    input: CharacterAutoCreateInput;
    characterId: number;
    presetId: number;
    portraitImageId?: number;
}): Record<string, unknown>;
export declare function autoCreateCharacters(inputs: CharacterAutoCreateInput[], options?: {
    projectSlug?: string;
    root?: string;
    apiKey?: string;
    apiUrl?: string;
    dryRun?: boolean;
    /** Generate + register each character's identity reference sheet (default true). */
    referenceSheet?: boolean;
    /** Go Bananas style-preset id for the sheet (default the Cinematic Character Reference Sheet). */
    sheetPresetId?: number;
}): Promise<Record<string, CharacterAutoCreateResult>>;
//# sourceMappingURL=character-auto-create.d.ts.map