ReadMessagesTool

Reads SMS from the inbox or sent box via ContentResolver on Telephony.Sms, optionally filtered by address and since (strict yyyy-MM-dd; an unparseable value is an error), newest first. address matches a raw case-insensitive substring, a digits-only substring after normalizing formatting (+1 (555) 010-9999 → +15550109999), or PhoneNumberUtils.compare (tolerates national vs international prefixes). A SQL LIKE pre-filter (SmsUtils.addressPrefilter) narrows the rows the provider returns, and SmsUtils.addressMatches is the precise check in the cursor loop. Requires READ_SMS. Output: messages (list of {id, address, body, date formatted yyyy-MM-dd HH:mm, read}), count, and the resolved box. box is 'inbox' (default) or 'sent'; limit clamps to 1–100 (default 10).