Search the user's COMPLETE email history by querying their connected
mail providers live — Gmail, Outlook AND IMAP accounts (iCloud, Yahoo and
other IMAP mailboxes) — reaching years beyond Mailopoly's indexed window,
and including sent mail. This is also how you reach mail a free trial
hasn't imported yet: the trial fully processes only recent mail, but the
rest still lives in the user's mailbox and this tool finds it. Use it when
search_emails returns few or no results, or when the question concerns
emails older than the indexed history (search_emails responses include
indexed_history_start). TIME BUDGET: the live crawl is deliberately
capped server-side (typically 5-45 seconds for Gmail/Outlook, up to ~90
seconds when an IMAP account like iCloud/Yahoo is being walked) so this
call ALWAYS returns a usable response before your own tool-call timeout —
never refuse to run it just because an account is iCloud/IMAP; just tell
the user you're searching their full history and it may take a moment.
If the crawl hits its budget the response says so in `note` and
`provider_error`, and the results returned are what was found in time.
PAGINATION is by date, not offset: re-run with end_date set to a
truncated provider's oldest_returned_date (from truncated_providers) to
page deeper into history, or narrow with a sender/start_date/end_date
window. start_date/end_date (YYYY-MM-DD) may span multiple years; omit
both to search ALL history. Returned email_id values (some of the form
'gmail:<id>:<id>' or 'imap:<id>:<uid>') work directly in get_email.
Connector