type Env = Record<string, string | undefined>;
export interface KnowledgeCredentialReferenceInput {
    reference: string;
    /** A full, existing item ID whose authorization the selected reference must prove. */
    verifyItemId: string;
    apply?: boolean;
    expectedPreview?: string;
}
type FileRevision = {
    device: string;
    inode: string;
    size: string;
    modified_ns: string;
    changed_ns: string;
    mode: number;
};
export interface KnowledgeCredentialReferenceResult {
    schema: 'knowledge.credential-reference.v1';
    reference: string;
    profile: null;
    credential_path: string;
    api_url: string;
    verification: {
        item_id: string;
        version: number;
    };
    existing: FileRevision | null;
    preview_digest: string;
    applied: boolean | null;
    snapshot_path: string | null;
    outcome: 'preview' | 'applied' | 'applied_unconfirmed' | 'ambiguous';
    reference_file_verified: boolean;
    directory_synced: boolean;
    cleanup_complete: boolean;
}
/** Preview by default. Neither result nor error contains credential values or item bodies. */
export declare function configureKnowledgeCredentialReference(input: KnowledgeCredentialReferenceInput, env?: Env): Promise<KnowledgeCredentialReferenceResult>;
export {};