outlook_changes_since
Retrieve a unified digest of changes since the last call: new and urgent flagged mail, top senders, and new or cancelled events and contacts. Supports delta tokens for incremental updates.
Instructions
One structured "since last call" digest across mail, events, and contacts.
Use this for recurring agent loops (morning brief, hourly inbox sweep) — one call returns counts, urgent_flagged mail, by-sender rollup, plus new/cancelled events and contacts counts. Use the three individual delta tools (outlook_list_inbox_delta, outlook_list_events_delta, outlook_list_contacts_delta) when you need raw item lists or per-resource control.
Example: first call: outlook_changes_since(); next:
outlook_changes_since(delta_tokens=).
First call returns a snapshot filtered to the last fallback_window_hours (default 24)
so the digest doesn't surface thousands of historical items; subsequent calls (tokens
passed back) return only what changed. Each resource's token is independent — drop
one stale token without re-syncing the others. If Graph 410s on a token
(syncStateNotFound), that resource auto-resyncs and _meta.resync lists which one.
urgent_flagged = high-importance OR flagged mail. by_sender = top 5 senders.
Calendar modified[] is reserved for future use — modified events surface in new[]
today (Graph delta doesn't distinguish them). Calendar organizer_email is also
currently empty (the v1.9.0 delta formatter surfaces the organizer name only).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| delta_tokens | No | ||
| fallback_window_hours | No |