В связи с обновлением класса, немного опишу методы для работы.
Вся работа с комментариями ведется через метод comment_json класса CommentTools. Результат он возвращает (сюрприз, сюрприз) в формате json. Не знаю, будет ли востребован формат xml. Если будет, может быть придется сделать обертку и для него.
Итак, методу передаются следующие обязательные значения:
action
token
comment_id (в случае добавления - id комментария на который отвечают. В остальных случаях - id комментария с которым работают )
 
action могут быть следующие:
 
comment_add - добавляет новый комментарий
возвращает
comment_id - идентификатор комментария
parent_id - идентификатор родителя
html - сгенерированный комментарий (генерируется из шаблона comment_ajax.tpl)
 
comment_edit - редактирует существующий комментарий
возвращает
comment_id
text_html - обработанный текст комментария (не комментарий целиком, а только его содержимое)
 
comment_delete - удалить комментарий
возвращает
comment_id
branch_id - в случае если комментарий удален физически
 
comment_undelete - восстановить комментарий
возвращает
comment_id
 
comment_delete_branch - удалить ветвь (текущий комментарий и все последующие)
возвращает
comment_id
 
comment_abuse - жалоба модератору
возвращает
comment_id
message - текст подтверждения
 
comment_get - получить комментарий
возвращает
comment_id
text - исходный текст комментария
 
в случае неудачи все методы возвращают {'error'=>'текст ошибки'}
 
Методы принимают параметры аналогичные своим "неасинхронным собратьям".
 
Если есть какие-то неясности или пожелания (может, стоит расширить количество возвращаемых данных), то высказывайтесь - будем вместе думать.