Thread overview
mail_thread_overviewGet a one-line-per-message overview of an email thread with date, size, sender, and subject changes. Use it to decide which messages to read in full before fetching the entire thread.
Instructions
One line per message: index, date, size, from, and a marker when the subject changes from the thread's root subject.
Use this before mail_read_thread on any thread you have not looked at yet, especially a long one: it costs a fraction of the tokens and lets you decide which one or two messages to actually read in full, instead of pulling all eighty. Do not use it in place of mail_read_thread when you already know you need the full content.
Args: thread_id: A thread identifier as returned by mail_search (with or without the 'thread:' prefix). layout: 'tree' (the actual reply nesting, from notmuch's own thread structure; for a patch series with parallel discussion strands this is materially different from linear order) or 'flat' (linear oldest-first order, matching mail_read_thread's [N/M] numbering).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| layout | No | tree | |
| thread_id | Yes |