#!/usr/bin/env node
export interface CharacterCardV2 {
    spec: string;
    spec_version: string;
    data: {
        name: string;
        description: string;
        personality: string;
        scenario: string;
        first_mes: string;
        mes_example: string;
        creator_notes: string;
        system_prompt: string;
        post_history_instructions: string;
        alternate_greetings: string[];
        tags: string[];
        creator: string;
        character_version: string;
        extensions: Record<string, unknown>;
        character_book?: {
            entries: Array<Record<string, unknown>>;
            extensions: Record<string, unknown>;
        };
        [key: string]: unknown;
    };
    create_date?: string;
    [key: string]: unknown;
}
/**
 * Read character card JSON from a PNG file.
 */
export declare function readCardFromPng(pngPath: string): CharacterCardV2;
/**
 * Write character card JSON back to a PNG file.
 */
export declare function writeCardToPng(pngPath: string, card: CharacterCardV2, outputPath?: string): void;
/**
 * List all PNG character card files in a directory.
 */
export declare function listCards(dir: string): string[];
/**
 * Get a field from the character card data using dot notation.
 * e.g. "data.name", "data.description", "data.character_book.entries"
 */
export declare function getCardField(card: CharacterCardV2, fieldPath: string): unknown;
/**
 * Set a field on the character card data using dot notation.
 */
export declare function setCardField(card: CharacterCardV2, fieldPath: string, value: unknown): void;
/**
 * Extract a character card PNG into workspace files.
 * Creates: workspace/cards/{name}/card.json + avatar.png
 */
export declare function extractCardToWorkspace(pngPath: string, workspaceDir: string): {
    cardJsonPath: string;
    avatarPath: string;
};
/**
 * Apply card.json from workspace back to the original PNG.
 */
export declare function applyCardFromWorkspace(cardDir: string, outputPath?: string): string;