List conversations, most recently active first.

Each entry carries the chat_guid needed by the other tools, the other participant's name where it is known, how many unread messages it holds, and a preview of the last message.

Read messages from one conversation, newest first.

Tapbacks and system events such as group renames are excluded: they are stored as messages but are not things anybody said.

Search message text across conversations, case-insensitively.

The entire history is searched, not a recent window, so a total of 0 means the text is genuinely not there. The total is a true count of matches; limit bounds only how many are returned.

List who is in a conversation, with their handles and service.

List received messages that have not been read yet, newest first.

List attachment metadata: name, type, size, direction and date.

The files themselves are not read, so this says what was sent, not what is in it.

Send a message to an existing conversation.

Only conversations that already exist can be addressed, by the chat_guid from list_chats. There is no way to start a new conversation, so this cannot reach somebody who has not been talked to before.

A sent message cannot be recalled.