/**
 * Fulltext convert operation.
 *
 * Converts an attached fulltext file (PMC JATS XML or PDF) to Markdown.
 */
import type { FulltextConfig } from "../../../config/schema.js";
import type { ILibrary, IdentifierType } from "../../../core/library-interface.js";
export interface FulltextConvertOptions {
    /** Reference identifier (id or uuid) */
    identifier: string;
    /** Identifier type: 'id' (default), 'uuid', 'doi', 'pmid', or 'isbn' */
    idType?: IdentifierType | undefined;
    /** Directory for fulltext attachments */
    fulltextDirectory: string;
    /** Input format: "xml", "pdf", or undefined for auto-detect */
    from?: "xml" | "pdf" | undefined;
    /** Converter name or "auto" */
    converter?: string | undefined;
    /** Force re-conversion (overwrite existing markdown) */
    force?: boolean | undefined;
    /** Fulltext config for converter settings */
    fulltextConfig?: FulltextConfig | undefined;
}
export interface FulltextConvertResult {
    success: boolean;
    error?: string;
    /** The converted markdown filename */
    filename?: string;
    /** Error hints for the user */
    hints?: string;
    /** Error code for structured error handling */
    code?: string;
    /** Converter stderr output (on failure) */
    stderr?: string;
}
export declare function fulltextConvert(library: ILibrary, options: FulltextConvertOptions): Promise<FulltextConvertResult>;
//# sourceMappingURL=convert.d.ts.map