fix(tool-index): add description mapping for new email and attachment tools

Katsoragi · Katsoragi · commit f17c78754fea · 2026-07-03T17:13:56.000+02:00
diff --git a/src/tool_index.py b/src/tool_index.py
@@ -108,6 +108,10 @@
     "ui_control": "Control the UI and toggle tools on/off. Use this to turn off / turn on / disable / enable individual tools and features: shell (bash), search (web), research, browser, documents, incognito. Open panels (documents library, gallery, email inbox, sessions, notes, memories/brain, skills, settings, cookbook) via `open_panel <name>`. Use `open_email_reply <uid> <folder> reply <body text>` (or structured body) to open an email reply draft document without sending. USE THIS whenever the user says to write/draft a reply or tells you what to say — opening an empty draft or sending immediately is wrong. Body can continue on subsequent lines for multi-line replies. Also switches between chat/agent modes, changes the current model, and applies/creates themes.",
     "list_email_accounts": "List configured email accounts and default status. Use before reading or sending mail when the user mentions Gmail, work mail, custom domain mail, another mailbox, or asks to compare/check multiple inboxes.",
     "list_emails": "List emails for a folder/account, newest first, including read messages by default. Shows subject, sender, date, UID, account, and AI summary. Check inbox, find emails needing replies. Supports account from list_email_accounts for Gmail/work/custom mailboxes. For last/latest/newest email, use max_results=1 and unread_only=false.",
+    "download_attachment": "Download an email attachment to disk by UID and attachment index. Returns the saved file path. Use read_email_attachment instead if you just need the text content inline.",
+    "read_email_attachment": "Read and extract text content from an email attachment inline. Supports plain text, HTML, and PDF files. Use this when you want to analyze or summarize attachment contents without saving to disk.",
+    "draft_email": "Start a new email draft in the editor. Returns a document ID the user can review and send.",
+    "draft_email_reply": "Start a reply draft in the editor for an existing email thread by UID. Returns a document ID the user can review and send.",
     "read_email": "Read the full content of a specific email by UID or Message-ID. View email body, check details. Supports account from list_email_accounts when the UID belongs to a non-default mailbox.",
     "send_email": "Send a new email via SMTP. Provide recipient, subject, body, and optional account from list_email_accounts. For replying to a thread use reply_to_email instead.",
     "reply_to_email": "SEND a reply email immediately by UID. Do not use for write/draft/open/start reply requests; use ui_control open_email_reply with body so the user can review. Only use when the user explicitly says to send now. For send requests, use the exact UID and account from latest read_email/list_emails output; never invent UID 1. Threads automatically with In-Reply-To/References, prefixes Re:, marks original as Answered.",
