Report the local archive status: whether a device is linked, when it last synced, and how many chats/messages are archived. Reads nothing from WhatsApp.

List archived chats (1:1 and group), ordered deterministically by name. Optionally filter by a name substring. Paginate with the returned cursor.

Find chats whose resolved name matches (case-insensitive substring). Use this to locate a named contact or group, e.g. before reading their full history.

Read a deterministic page of a chat's message history. direction "forward" reads oldest→newest; "backward" scrolls up (newest→oldest). Returned messages are always chronological; pass the cursor back to continue. Iterate until hasMore is false for complete readback.

Fetch a single archived message by chat JID and message id, with exact timestamp and content.

List archived messages in a chat that carry an attachment (image/video/audio/document/sticker), with metadata and whether bytes are downloaded. Deterministic forward pagination.

Return an approved attachment's locally-archived bytes. Requires approved: true for the specific message (and passes the operator allowlist, if configured). Never fetches from WhatsApp — only surfaces bytes the collector already downloaded.